鉴权
所有接口都用 API Key 鉴权。Key 在控制台创建，以 sk-moyiapi- 开头；Key 应仅保存在服务端，不应写入前端代码或提交到代码仓库。
使用 API Key
模驿API 接受三种鉴权请求头，按所用协议或 SDK 选择：
| 请求头 | 适用端点 | 谁会用到 |
|---|---|---|
Authorization: Bearer sk-moyiapi-xxxxxx |
全部端点 | 直接调用，以及 OpenAI SDK（设置 api_key） |
x-api-key: sk-moyiapi-xxxxxx |
全部端点 | Anthropic SDK（设置 api_key），配合 anthropic-version: 2023-06-01 |
x-goog-api-key: sk-moyiapi-xxxxxx |
仅 Gemini 原生端点 /v1beta/models/... |
Google GenAI SDK |
使用官方 SDK 时，将 api_key 设为 模驿API API Key、base_url 指向 模驿API，SDK 会自动添加对应请求头；各 SDK 的完整示例见模型与路由。直接调用 HTTP 接口时任选一种：
curl https://api.moyiapi.cn/v1/chat/completions \
-H "Authorization: Bearer sk-moyiapi-xxxxxx" \
-H "content-type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "你好"}]
}'
鉴权失败统一返回 401，error.type 说明原因：
error.type |
触发条件 |
|---|---|
missing_auth_credential |
没有带任何受支持的鉴权请求头，或在非 Gemini 端点只带了 x-goog-api-key |
invalid_api_key |
x-api-key 或 x-goog-api-key 里的 Key 不正确、不完整或已删除 |
invalid_bearer_token |
Authorization: Bearer 里的 Key 不正确、不完整或已删除 |
Key 泄露后的处理
在控制台删除泄露的 Key，并创建新的 Key 替换。已删除的 Key 无法再通过鉴权，使用它的请求将收到 401。