Ori联系我们

文档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 停

接着看