接口开放状态
本文档列出每一类接口当前是否可用。这不是猜测 —— 状态取自平台自身的模型能力声明。
状态图例
| 标记 | 含义 | 你该怎么做 |
|---|---|---|
| ✅ 已开放 | 路由与渠道都已就绪,用当前令牌即可调用 | 直接调 |
| 🟡 路由就绪 | 接口路径与转发逻辑已实现,但当前尚无渠道声明该能力 | 调用会返回「模型不支持」类错误;等平台开放后无需改代码 |
| ❌ 未实现 | 该端点不提供,调用返回明确错误 | 换接口或自行实现 |
:::tip 为什么要分「已开放」和「路由就绪」 路由层与渠道层是两件事。
路由层决定「这个路径会不会被转发、请求体怎么转、响应怎么解析」——这部分写死在代码里,一旦实现就长期有效。 渠道层决定「有没有实际上游愿意提供这个能力」——这部分随运营调整。
所以 🟡 状态的接口代码路径已经通,等渠道一开就能用,你的客户端配置和请求格式都不用改。 :::
当前总览
| 能力 | 端点 | endpoint type | 状态 | 分组 |
|---|---|---|---|---|
| 对话(OpenAI 协议) | POST /v1/chat/completions | openai | ✅ 已开放 | default |
| 对话(Anthropic 协议) | POST /v1/messages | anthropic | ✅ 已开放 | default |
| Responses | POST /v1/responses | openai-response | 🟡 路由就绪 | — |
| Responses 压缩 | POST /v1/responses/compact | openai-response-compact | 🟡 路由就绪 | — |
| 独立搜索(Codex 场景) | POST /v1/alpha/search | openai-alpha-search | 🟡 路由就绪 | — |
| 工具搜索 | POST /v1/tools/search | deepseek-tools-search | 🟡 路由就绪 | — |
| 工具抓取 | POST /v1/tools/fetch | deepseek-tools-fetch | 🟡 路由就绪 | — |
| Gemini 原生 | POST /v1beta/models/{model}:generateContent | gemini | 🟡 路由就绪 | — |
| 重排序 | POST /v1/rerank | jina-rerank | 🟡 路由就绪 | — |
| 图片生成 | POST /v1/images/generations | image-generation | 🟡 路由就绪 | — |
| 图片编辑 | POST /v1/images/edits | image-generation | 🟡 路由就绪 | — |
| 向量化 | POST /v1/embeddings | embeddings | 🟡 路由就绪 | — |
| 语音合成 | POST /v1/audio/speech | — | 🟡 路由就绪 | — |
| 语音转写 | POST /v1/audio/transcriptions | — | 🟡 路由就绪 | — |
| 语音翻译 | POST /v1/audio/translations | — | 🟡 路由就绪 | — |
| 视频 / 音乐任务 | POST /v1/tasks/{key} | openai-video 等 | 🟡 路由就绪 | — |
| 内容审核 | POST /v1/moderations | — | 🟡 路由就绪 | — |
| WebSocket 实时 | GET /v1/realtime | — | 🟡 路由就绪 | — |
未实现的端点
以下端点不提供,调用会得到错误响应,而不是静默降级:
POST /v1/images/variations
GET /v1/files
POST /v1/files
GET /v1/files/{id}
GET /v1/files/{id}/content
DELETE /v1/files/{id}
POST /v1/fine-tunes
GET /v1/fine-tunes
GET /v1/fine-tunes/{id}
POST /v1/fine-tunes/{id}/cancel
GET /v1/fine-tunes/{id}/events
DELETE /v1/models/{model}
POST /v1beta/models/{model}:countTokens
:::warning 别在客户端静默吞掉这些错误
countTokens 会返回 404,不是"返回 0"。如果你的 SDK 依赖它做上下文预算,需要自己实现本地估算。
:::
当前可用的模型与分组
线上当前的模型能力声明(取自 /api/pricing):
| 模型 | 支持协议 | 可用分组 |
|---|---|---|
claude-opus-4-5 | openai、anthropic | default |
MiniMax-M2.5 | openai、anthropic | default |
信息
模型、分组会随运营调整。以控制台模型广场的实时显示为准。 本文档只标注「接口层面是否打通」,具体有哪些模型请看 模型广场。
自己验证开放状态
不依赖文档,直接问平台:
# 1. 看当前令牌能调哪些模型、各自支持什么协议
curl https://187api.com/v1/models \
-H "Authorization: Bearer ***"
# 2. 看模型广场的完整能力声明
curl https://187api.com/api/pricing
/api/pricing 返回的每个模型都带 supported_endpoint_types 和 enable_groups 字段 —— 这就是上表的权威来源。
排错:明明文档说能用,为什么报「模型不支持」
| 原因 | 判断方法 | 处理 |
|---|---|---|
| 该能力当前是 🟡(渠道未开放) | /api/pricing 里没有对应 endpoint type | 等开放,或换已开放的能力 |
| 令牌分组不含该模型 | 报 403 | 换分组,见 令牌分组说明 |
| 「模型可用列表」限制了 | 报 403 | 把列表留空,见 创建 API 令牌 |
| 模型名写错 | 报 model_not_found | 用 /v1/models 返回的准确名字 |