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

📖 概述#

🌐 接口地址#

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

🎯 使用方法#

ℹ️ 基础信息#

🤖 支持的模型列表#

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

阿里云千问系列，覆盖旗舰、均衡、高速等多层次模型，全面支持 Function Calling 和流式输出。最新 Qwen3.5 系列支持百万级上下文。

2. DeepSeek#

DeepSeek 系列模型，最新的 V3.2 引入了稀疏注意力机制（DSA），大幅降低推理成本并提升长上下文处理能力。

⚠️ deepseek-reasoner 注意事项：

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

不支持 Function Calling

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

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

3. xAI（Grok）#

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

4. 智谱 AI（GLM）#

智谱 AI 的 GLM 系列模型，最新 GLM-5 采用动态稀疏注意力（DSA）机制，在对话、代码、Agent 任务等方面表现出色。

5. MiniMax#

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

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

月之暗面的 Moonshot 和 Kimi 系列，以超长上下文处理和 Agent 能力著称。最新 Kimi K2.5 支持原生多模态。

💻 请求示例#

Python 示例代码#

💡 API Key。获取地址：https://api.tokenhot.cn/api-key

cURL 示例#

OpenAI SDK 示例（Python）#

Node.js 示例#

📤 返回示例#

成功响应结构#

{
  "id": "chatcmpl-abc123def456",
  "object": "chat.completion",
  "created": 1711712000,
  "model": "qwen-max",
  "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 客服。