跳转到主要内容
ByteSpike 在一把 API key 后面暴露一组数量少、定义清晰的 endpoint。每一个都对应 不同的客户端形态 —— 已有的 SDK、Agent 框架、多模态流水线。网关在各协议之间 做翻译，让你不用再写各家厂商的胶水代码。 原则： 挑你客户端本来就会讲的那种协议；剩下的交给网关。

​
Endpoint 全貌

#Endpoint路径适用客户端
1Anthropic MessagesPOST /v1/messagesAgent 框架 · Claude SDK · DOSIA · Claude Code
2OpenAI ResponsesPOST /v1/responsesOpenAI Codex CLI · OpenAI Agents SDK · 重推理的客户端
3OpenAI Chat CompletionsPOST /v1/chat/completions最普及的 chat 形状 · openai SDK · 大多数编辑器集成
4Gemini NativePOST /v1beta/models/{model}:generateContentGoogle 的 CLI / SDK · Vertex 兼容客户端
5Image Generation（同步）POST /v1/images/generations · /v1/images/editsOpenAI 形状的图像 SDK · 单次调用图像生成
6异步多模态任务POST /v1/tasks/submit · /v1/tasks/query · /v1/tasks/cancel视频生成（Sora、Veo、Seedance）· 批量图像渲染
就这些。没有 /v1/embeddings、没有 /v1/audio/*、没有 /v1/rerank、没有 /v1/assistants —— ByteSpike 当前不暴露这些。

​
1. Anthropic Messages —— /v1/messages

ByteSpike 的看家 agent 协议。tool_use、cache_control、thinking、web_search 四种 block 全程保留。适合：
  • 你在做 agent，需要显式的 tool-call / tool-result block
  • 你想在 Opus / Sonnet 4.x 上用 extended thinking
  • 客户端是官方 anthropic SDK（Python / Node）或其衍生
原生支持 Claude 模型；DeepSeek、Gemini、GPT 模型经透明翻译也可用 —— 在 model 字段里传任意目录模型即可。 详见 /v1/messages 参考。

​
2. OpenAI Responses —— /v1/responses

OpenAI 较新的 agent 风格协议（Codex CLI + Agents SDK）。适合：
  • 客户端是 OpenAI Codex CLI
  • 你想把 structured-outputs 和 reasoning 一起用
  • 你在用 OpenAI Agents SDK
原生支持 GPT 模型；Claude、Gemini 模型经透明翻译也可用。 详见 /v1/responses 参考。

​
3. OpenAI Chat Completions —— /v1/chat/completions

生态里最普及的 chat 形状。几乎所有 SDK 都会讲。适合：
  • 你已有 openai SDK 代码，想用最省事的路径
  • 你不是在写 agent —— 一来一回的 chat
  • 你要调非 OpenAI 模型但想继续用 OpenAI SDK
支持 GPT、Gemini、DeepSeek、Kimi（Moonshot）、GLM（Zhipu）、MiniMax、 Doubao（字节跳动）模型 —— 在 model 字段里传任意目录模型即可。 详见 /v1/chat/completions 参考。

​
4. Gemini Native —— /v1beta/models/{model}:generateContent

Google 的原生协议原样透传。适合：
  • 你在用 Google 官方 CLI 或 SDK
  • 你想用原生形式的 grounding（googleSearch 工具）
  • 下游工具链需要 Gemini 准确的响应形状
流式走 :streamGenerateContent?alt=sse。该协议只服务 Gemini 家族。 详见 /v1beta/... 参考。

​
5. 图像生成（同步）—— /v1/images/generations + /v1/images/edits

各家 provider 都用 OpenAI 形状的请求体；model 字段决定路由。用于：
  • 单提示词图像生成（GPT-Image-2 形状）
  • 配合 mask 或指令的图像编辑
服务 GPT-Image-2 与 GPT-4o-image 模型、Seedream（字节跳动）家族（V4 / V4.5 / V5lite）、以及 Nano-Banana（Google）家族 —— 全都走同一套 OpenAI 形状请求体。

​
6. 异步多模态任务 —— /v1/tasks/{submit, query, cancel, stream}

视频与长耗时图像生成走异步任务模型：submit 立刻返回 task_id，可以轮询 /tasks/query，也可以在 /tasks/stream/{task_id} 上通过 SSE 流式获取状态变化。 用于：
  • 视频生成（Sora 2、Veo 3.1、Seedance）—— 都需要 10-60s 以上
  • 想”提交即走”的批量图像生成
  • 高并发生产者，不希望让 HTTP 连接长期挂着
详见 /tasks/submit 参考。

​
各模型家族可走哪些协议

每个模型家族在 ByteSpike 上能通过哪些协议调用。✅ = 支持；— = 该协议不可用。
模型家族Anthropic MessagesOpenAI ResponsesOpenAI ChatGemini NativeImage（同步）Async tasks
Claude（Anthropic）✅translatedtranslated———
GPT（OpenAI）translated✅✅—✅✅（Sora）
Gemini（Google）translatedtranslated✅（shim）✅—✅（Veo）
DeepSeek✅（V3-anthropic、V4）—✅———
Kimi（Moonshot）✅—✅———
GLM（Zhipu）——✅———
MiniMax——✅———
Doubao（字节跳动）——✅—✅（Seedream）✅（Seedance）
实时、对应你账号的清单，请调 GET /api/v1/me/available-models， 或者在 console 任一模型旁点 Test。

​
按客户端挑

你的客户端用这个 endpoint
Claude CodeAnthropic Messages
Claude DesktopAnthropic Messages
Anthropic SDK（Python / Node）Anthropic Messages
Cursor / Continue / Cline / ZedOpenAI Chat Completions
OpenAI Python / Node SDKOpenAI Chat Completions
OpenAI Codex CLIOpenAI Responses
OpenAI Agents SDKOpenAI Responses
Google Gemini CLI / SDKGemini Native（或 OpenAI shim）
AiderOpenAI Chat Completions（或通过 SDK base URL 覆盖）

​
场景

你想要Endpoint
带 tool_use + thinking 的 agentAnthropic Messages
现有 openai SDK 代码、零改写Chat Completions
Codex CLI / OpenAI Agents SDKOpenAI Responses
不改 SDK 代码就在 Claude / GPT / Gemini 之间切换大多数场景用 Chat Completions；需要 cache_control 或 thinking 时用 Anthropic Messages
生成图像Image（同步）
生成视频Async tasks

​
一个 key、多 endpoint

ByteSpike 的 API key 目前绑定到 一个 路由分组（group_id）。分组决定 key 能触达哪些模型家族。在同一个分组内，这些模型支持的所有 endpoint 形状都可用 —— 例如，绑在 claude-default 上的 key 可以对 Claude 模型调 /v1/messages、/v1/chat/completions（经翻译）、/v1/responses（经翻译）。 要触达不同分组里的模型家族，就建多把 key（每个分组一把），按请求选用。详见 鉴权。

​
下一步

  • 模型 —— 完整目录，含价格与协议
  • 多模态概念 —— 同步图像与异步视频的计费差异
  • 错误处理 —— 重试、幂等性、流式错误