文档OriHub
文本模型调用
四种协议格式,按模型挑;端点、鉴权、通用规则都在这页。
平台上的文本(聊天)模型都能调,走四种协议格式之一 —— 换句话说,用哪个厂商的 SDK 都不重要,取决于这个模型支持哪种格式。
四种格式
| 协议 | 端点 | base_url |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions |
https://api.lk888.ai/v1 |
| OpenAI Responses | /v1/responses |
https://api.lk888.ai/v1 |
| Anthropic Messages | /v1/messages |
https://api.lk888.ai |
| Gemini Generate Content | /v1beta/models/{model}:{action} |
https://api.lk888.ai |
四个端点都是 POST。
哪些模型走哪套:
- OpenAI Chat Completions —— GPT、DeepSeek、Qwen、豆包、Grok、Kimi、GLM、MiniMax 等 56 个
- OpenAI Responses —— GPT 全系 13 个,跟 Chat Completions 同一批模型,二选一
- Anthropic Messages —— Claude 系列 13 个
- Gemini Generate Content —— Gemini 系列 10 个
每个模型支持哪几种,模型列表里逐个标着。
鉴权
所有端点都要带密钥:
export OPENAI_API_KEY=sk-xxxxxxxx
请求头统一用 Authorization: Bearer {API_KEY}。Anthropic 那套额外认 x-api-key(Anthropic SDK 默认就发这个),Gemini 那套也能把密钥放 URL 参数 ?key=。
必填参数
| 格式 | 必填 |
|---|---|
| OpenAI Chat Completions | model、messages |
| OpenAI Responses | model、input(字符串或消息数组) |
| Anthropic Messages | model、messages、max_tokens |
| Gemini Generate Content | contents(模型名和 action 写在 URL 上) |
通用规则
- 流式:OpenAI 两条端点加
stream: true;Anthropic 用stream: true;Gemini 换 action(streamGenerateContent)。各家的事件格式不一样,别混着解析 - 用量:响应里都带 token 数(OpenAI 是
usage.prompt_tokens/completion_tokens,Anthropic 是usage.input_tokens/output_tokens,Gemini 是usageMetadata.promptTokenCount/candidatesTokenCount) - 这次花了多少:响应头
X-Task-Id是本平台的任务号,拿它调GET /v1/skills/task-status?task_id={X-Task-Id},is_final = true时的cost就是结算金额 - 路由由密钥的调度策略决定(价格优先 / 速度优先 / 成功率优先),请求体里的
channel_group和请求头X-Channel-Group都不改路由 - 图片、视频、音频不走这些端点 —— 走
POST /v1/media/generate提交任务,再轮询GET /v1/skills/task-status?task_id=...,间隔 5 秒,is_final = true停
接着看
- Anthropic SDK / OpenAI SDK / AI SDK —— SDK 怎么写
- Anthropic Messages API / OpenAI Chat Completions API / OpenAI Responses API —— 协议细节