> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tikway.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 协议转换

> 以统一的调用方式，连接不同厂商与不同类型的 AI 模型。

## 概述

不同模型提供商通常拥有不同的接口格式、字段命名、鉴权机制与响应结构。Tikway 在网关层处理支持范围内的协议差异，将多种模型接入同一个 API 入口。

先选择应用使用的请求协议，再调用该协议对应的路径。路径决定请求和响应的结构；`model` 决定模型。不同模型对参数、工具和多模态输入的支持范围可能不同。

| 请求协议 | 入口路径 | 鉴权请求头 |
| - | - | - |
| OpenAI Chat Completions | `/v1/chat/completions` | `Authorization: Bearer` |
| OpenAI Responses | `/v1/responses` | `Authorization: Bearer` |
| Anthropic Messages | `/v1/messages` | `x-api-key` |
| Gemini Generate Content | `/v1beta/models/{model}:generateContent` | `x-goog-api-key` |

完整地址与示例见[网关与鉴权](/zh/develop-guide/gateway-auth)。

## 统一调用体验

对支持 Chat Completions 的模型，可以使用同一种请求结构调用：

```bash theme={null}
curl https://api.tikway.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-terra",
    "messages": [
      {
        "role": "user",
        "content": "为一家独立咖啡馆写一句简洁的品牌标语。"
      }
    ]
  }'
```

在同一协议内切换模型时，通常先调整 `model` 字段，再检查目标模型是否支持当前请求的工具、图片、音频和采样参数：

```json theme={null}
{
  "model": "provider/model-name",
  "messages": [
    {
      "role": "user",
      "content": "Your prompt"
    }
  ]
}
```

## Tikway 负责处理什么

Tikway 在统一接口与底层模型之间完成必要的协议适配，包括：

* 根据模型标识路由至对应的模型服务。
* 转换不同供应商的请求字段与参数规范。
* 统一身份认证与访问控制方式。
* 规范化接口响应，降低应用层的适配成本。
* 将新模型接入纳入既有开发流程，减少迁移工作。

协议适配不会让所有模型拥有相同能力。例如，一个模型不支持某个工具或输出格式时，网关可能拒绝该参数；网关生成的错误格式遵循你调用的入站协议。排错时查看[状态码与响应](/zh/develop-guide/status-code-response)。

## 适合的使用场景

<CardGroup cols={2}>
  <Card title="快速切换模型" icon="arrow-right-arrow-left">
    在不重写业务调用逻辑的前提下，尝试不同模型的能力、速度与成本表现。
  </Card>

  <Card title="构建多模型应用" icon="layers">
    在同一产品内，为不同功能选择最合适的语言、图像、视频或音乐模型。
  </Card>

  <Card title="降低维护成本" icon="wrench">
    减少对多家供应商 SDK、鉴权方式和接口差异的长期维护。
  </Card>

  <Card title="平滑产品演进" icon="sparkles">
    在模型能力持续更新时，以更低成本扩展产品边界。
  </Card>
</CardGroup>

## 选择模型，而非重写集成

协议转换的价值不只是让接口“能调用”，而是让模型替换与能力扩展成为产品决策，而不是工程负担。

在接入前，请查阅对应模型的接口文档，确认其支持的参数、输入类型与输出形式。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.