OpenAI 兼容格式 — 大模型统一调用文档

概述#

接口地址#

https://api.tokenhot.cn/v1/chat/completions

使用方法#

基础信息#

支持的模型列表#

1. GPT（OpenAI）#

OpenAI 的 GPT 系列模型，全球领先的大语言模型家族。最新 GPT-5.x 系列在推理、代码生成和多模态方面持续突破，全面支持 Function Calling 和流式输出。

2. Claude（Anthropic）#

Anthropic 的 Claude 系列模型，以安全性、长上下文理解和精确指令遵循著称。最新 Claude 4.x 系列在复杂推理、代码生成和多语言任务方面表现卓越。

3. Gemini（Google）#

Google 的 Gemini 系列模型，原生多模态架构，支持文本、图像、音频、视频等多种输入。最新 Gemini 3.x 系列进一步增强推理和工具使用能力。

4. 千问（Qwen）— 阿里云#

阿里云千问系列，覆盖旗舰、均衡、高速等多层次模型，全面支持 Function Calling 和流式输出。最新 Qwen3.6 系列进一步提升推理与多模态能力，支持百万级上下文。

5. DeepSeek#

DeepSeek 系列模型，最新的 V4 系列在推理效率和生成质量上实现重大突破，V3.2 引入了稀疏注意力机制（DSA），大幅降低推理成本并提升长上下文处理能力。

⚠️ deepseek-reasoner 注意事项：

不支持 temperature、top_p、presence_penalty、frequency_penalty 参数

不支持 Function Calling

响应中会包含额外的 reasoning_content 字段

多轮对话时需从历史消息中移除 reasoning_content

6. xAI（Grok）#

xAI 公司的 Grok 系列模型，最新 Grok 4.x 系列采用多智能体协作架构，支持超长上下文和深度推理。

7. 智谱 AI（GLM）#

智谱 AI 的 GLM 系列模型，最新 GLM-5.1 在推理深度与指令遵循方面进一步升级，GLM-5 采用动态稀疏注意力（DSA）机制，在对话、代码、Agent 任务等方面表现出色。

8. MiniMax#

MiniMax 系列模型，最新 M2.7 系列专注 Agent 工作流和高级推理，支持 OpenAI 和 Anthropic 双协议。

9. 月之暗面（Moonshot / Kimi）#

月之暗面的 Moonshot 和 Kimi 系列，以超长上下文处理和 Agent 能力著称。最新 Kimi K2.6 进一步提升推理与多模态能力，K2.5 支持原生多模态和思维链推理。

请求示例#

Python 示例代码#

💡 提示： 实际使用时请将 sk-********************************** 替换为你的真实 API Key。获取地址：https://tokenhot.ai/api-key

cURL 示例#

OpenAI SDK 示例（Python）#

Node.js 示例#

返回示例#

成功响应结构#

{
  "id": "chatcmpl-abc123def456",
  "object": "chat.completion",
  "created": 1711712000,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "量子计算是一种基于量子力学原理的新型计算模式。与传统计算机使用比特（0或1）不同，量子计算机使用量子比特（qubit），它可以同时处于0和1的叠加态..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 156,
    "total_tokens": 184
  }
}

响应字段说明#

请求参数说明#

messages 数组中的消息角色#

错误码与错误响应说明#

错误码概览#

400 — 业务错误（BusinessError）#

{
  "code": "video_url_required",
  "message": "model doubao-seedance-2.0-V2V requires video_url content",
  "data": null
}

401 / 503 — 网关错误（GatewayError）#

{
  "error": {
    "code": "",
    "message": "无效的令牌 (request id: 20260327...)",
    "type": "new_api_error"
  }
}

{
  "error": {
    "code": "model_not_found",
    "message": "当前分组没有可用的渠道 (request id: 20260330...)",
    "type": "new_api_error"
  }
}

📌 温馨提示： 不同模型在部分参数支持上可能略有差异（例如 deepseek-reasoner 不支持 temperature），具体请参考各模型的详细说明。如有疑问，请联系 TokenHot 客服。