← Retour aux guides

开发者十分钟上手：看懂 OpenAI 兼容聊天补全格式

先理解：兼容的是接口，不是所有模型行为

OpenAI 兼容聊天补全格式，是用统一的 HTTP 请求结构调用不同模型：提交模型名称与消息列表，再从响应中读取回答。对忙碌的开发者，价值很直接：保留现有 SDK 和业务逻辑，主要修改接口地址、密钥与模型名称。

但格式兼容不等于能力完全一致。上下文长度、图片输入、工具调用及可用参数，仍取决于具体模型和服务端实现。不要把某个 GPT 模型的完整参数原样复制给所有 Claude 模型。

第一步：确定地址、密钥与模型

59API 的 API 基础地址为 https://api.59api.com。若采用标准 /v1 路径，OpenAI SDK 的 base_url 应填写 https://api.59api.com/v1，对应聊天补全地址为 https://api.59api.com/v1/chat/completions；具体路径以控制台接入说明为准，避免重复拼接 /v1。

• 认证：通过 Authorization: Bearer 你的密钥 发送凭据，密钥放在服务端环境变量，不要写进网页或提交到仓库。
• 请求类型：使用 POST，并设置 Content-Type: application/json。
• 模型名称：复制控制台公布的模型标识，不要直接拿产品展示名猜测。

第二步：看懂最小请求体

{"model":"替换为可用模型标识","messages":[{"role":"system","content":"你是一名简洁的编程助手。"},{"role":"user","content":"解释 HTTP 429，并给出处理建议。"}]}

model 决定调用哪个模型；messages 是按时间顺序排列的对话。system 通常承载全局指令，user 表示用户输入，assistant 表示模型先前的回答。某些模型也支持 developer 等角色，应按模型说明选用。

多轮聊天时，需要重新提交相关历史消息；接口不会仅凭之前的一次调用自动记住整段会话。历史越长，输入成本通常越高，因此只保留必要上下文。纯文本 content 可以直接使用字符串，多模态输入则可能需要内容数组。

第三步：用现有 SDK 发出请求

先运行 pip install openai，并设置环境变量 API59_KEY 与 API59_MODEL。下面的 Python 示例可以保存为脚本执行：

import os; from openai import OpenAI; client = OpenAI(api_key=os.environ["API59_KEY"], base_url="https://api.59api.com/v1"); result = client.chat.completions.create(model=os.environ["API59_MODEL"], messages=[{"role":"user","content":"用三句话解释数据库索引。"}]); print(result.choices[0].message.content)

普通文本响应主要读取 choices[0].message.content。排查问题时，同时查看 finish_reason 与 usage：前者说明为何停止，后者通常记录输入、输出及总 token 用量。若内容被截断，应检查模型输出限制，而不是盲目重复请求。

第四步：区分流式响应与工具调用

需要逐字显示时，添加 stream=true。底层通常使用 SSE，SDK 会把数据转换成可迭代分块。应逐块拼接 choices[0].delta.content，忽略没有文本的分块；不要按普通响应读取 message.content，也不要假设每块都包含完整句子。

使用 tools 时，模型可能返回 tool_calls 而不是直接回答。程序需要校验工具名称和参数、执行获准操作，再以 role=tool 和对应 tool_call_id 回传结果，最后继续请求模型。模型提出工具调用，不代表工具已经执行；涉及付款、删库等操作仍须权限控制。

第五步：先跑通，再优化费用

• 401：检查密钥、认证头和密钥所属服务。
• 400 或模型不存在：检查路径、模型标识及不受支持的参数。
• 429：检查余额与限流提示；适用时遵循 Retry-After，采用有上限的指数退避。
• 超时或 5xx：记录错误信息并有限重试，避免重复执行有副作用的工具。

59API 提供 Claude 与 GPT 的低价按量调用，属于价格较低的中转选择，提供原生官方品质模型、不做模型降级，适合先用小请求验证，再逐步接入生产。比较费用时，应同时看输入、输出单价与实际任务效果，而非只看单项最低价。

如果你已有 OpenAI SDK 项目，可以注册 59API，用一个短请求验证兼容性；邀请返利可作为额外优惠，具体规则以平台说明为准。上线前，再为实际使用的模型补齐流式、工具调用和异常处理测试。

Tarifs · Docs