← Retour aux guides

59API cURL 首条请求：GPT-6.1 Sol 接入教程

第一个请求卡住，往往不是模型的问题

很多开发者第一次接入大模型 API，真正让人停滞的往往不是模型能力，而是接入路径：文档散落、鉴权方式不统一、计费规则看不懂，想跑通一条请求就得反复试错。59API 的思路很直接：一个账号、一个 API key、一个 API 主机，就能在 Claude、GPT、Gemini、DeepSeek 等模型之间切换。它是独立的第三方 AI API 中转服务，统一入口为 https://api.59api.com，把原本分散的模型调用收敛到同一套配置里。

对刚起步的开发者来说，最省事的方式就是先用 cURL 发一次最小请求：确认域名、鉴权头、模型 id 和返回结构都能跑通，再把它搬进自己的服务或工具链。这样排查时你能明确区分是网络、密钥、模型名还是代码逻辑的问题，而不是同时怀疑一整条链路。

本文带你完成这件事：以 GPT-6.1 Sol 为例，从准备密钥、写命令、读返回，一直讲到估算这次请求大概要花多少钱。命令可以直接复制，参数可以替换，配置逻辑则是通用的。看完之后，你应该能独立完成自己的第一次 59API 请求。

整个过程没有月费，也没有必须先买卡的前提：充值后按真实 token 用量扣费，余额永不过期，用多少算多少。

动手前：密钥、充值与两个地址

开始之前先准备两样东西：59API 账号，以及账号下的 API key。登录 https://59api.com 后在控制台获取密钥，调用时把它放进请求头。密钥本身不会自动产生费用，费用来自真实请求的 token 用量，所以开始前只要确认账户余额充足即可。

充值支持 ¥10、¥50、¥100、¥200、¥500、¥1000 几个档位，可用微信支付或银行卡支付，需要发票也可申请。59API 采用预付余额模式，按请求的真实 token 用量计费，没有月费，余额永不过期；月卡和周卡是可选的，不是必买项。第一次验证请求，充一笔小额度就足够起步。

接入地址只有一个主机：https://api.59api.com。对于 cURL、OpenAI SDK、Codex，以及 Cursor、Cherry Studio、Cline、OpenCode 这类 OpenAI 兼容客户端，base_url 写 https://api.59api.com/v1，聊天补全接口是 https://api.59api.com/v1/chat/completions。

把这两行记下来就够了。59API 不需要你为不同模型准备不同的中转地址，切换模型时改的只是 model 字段，host 和 key 保持不变。

第一条 cURL 命令怎么写

现在写第一条命令。OpenAI 兼容接口用 POST 请求，路径是 /v1/chat/completions，鉴权放在 Authorization 头里，值是 Bearer 加上你的 59API key，请求体用 JSON 指定 model 与 messages。整条命令如下：

curl https://api.59api.com/v1/chat/completions \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_59API_KEY' \ -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"用一句话介绍你自己"}]}'

逐行看：URL 用完整接口地址，避免拼接出错；Content-Type 告诉服务端这是 JSON；Authorization 承载你的密钥，务必替换 YOUR_59API_KEY；-d 里是请求体，model 必须写准确的模型 id，messages 是对话数组，role 为 user 表示你发出的提问。

成功时会返回一段 JSON，里面包含 choices、message 等字段，模型回复在 message 的 content 中。如果没返回内容，排查顺序也很清晰：先看状态码，再看 URL 里的 /v1 是否写对，然后确认 key 是否复制完整、是否带了 Bearer 前缀，最后核对 model 是不是列表里的准确 id。

把这条命令跑通，你就完成了 59API 的第一次请求验证。接下来要做的，只是把同样的 host、鉴权头和请求结构搬进你自己的代码。

换模型之前，先搞清协议边界

这一步很关键：59API 的不同模型家族走的不是同一套协议，混用会直接失败。Claude 模型只能在官方 Claude Code 或 Claude Desktop 客户端中使用（Claude Code 2.1.285 或更新版本），对应配置是 ANTHROPIC_BASE_URL=https://api.59api.com 与 ANTHROPIC_AUTH_TOKEN=YOUR_59API_KEY；它们不通过 OpenAI SDK、cURL 或其他客户端调用，所以本文这条 cURL 命令不能用来请求 Claude 模型。

Gemini 模型使用 Google 原生协议，只能在 Gemini CLI 中使用，对应配置是 GOOGLE_GEMINI_BASE_URL=https://api.59api.com 与 GEMINI_API_KEY=YOUR_59API_KEY；它不是 OpenAI 兼容接口，在 /v1/chat/completions 上请求不到 Gemini 模型。

而 GPT、DeepSeek 以及其他非 Claude、非 Gemini 的模型，则可以走上面这条 OpenAI 兼容路径：cURL、OpenAI SDK、Codex、Cursor、Cherry Studio、Cline、OpenCode 都能用，同一套 base_url 与鉴权方式即可。也就是说，cURL 脚本里可以自由替换的，是 GPT、DeepSeek 这类模型的 model id。

所以实践建议很明确：先用 cURL 验证 GPT 或 DeepSeek 链路，把 OpenAI 兼容调用彻底跑顺；Claude 交给 Claude Code 或 Claude Desktop，Gemini 交给 Gemini CLI 各自的原生协议配置，不必把所有模型塞进同一个脚本。

这次请求大概要花多少钱

59API 的价格按每 100 万 token 计价，以人民币结算，按请求的真实 token 用量扣费。以本文示例模型为例，GPT-6.1 Sol（模型 id 为 gpt-6.1-sol）输入 ¥1.33、输出 ¥6.67、缓存读取 ¥0.27；GPT-5.6 Sol 输入 ¥2.5、输出 ¥14、缓存读取 ¥0.2；DeepSeek V4 Flash 输入 ¥2、输出 ¥8、缓存读取 ¥0.05。

用一个具体场景感受量级。假设 GPT-6.1 Sol 跑 5M 输入加 1M 输出 token、不使用缓存，在 59API 的费用是 ¥13.32，而按官方标价 $20（约 ¥144）计算，59API 约为标价的 9%。再看 GPT-5.6 Sol，2M 输入加 0.5M 输出、不使用缓存，在 59API 是 ¥12，官方标价 $18（约 ¥129.6），同样约为标价的 9%。这里的官方标价仅作参考价格对比。

回到第一次请求：一句简单的问候消耗的 token 很少，费用同样很低，但账单的计费逻辑始终是真实 token 用量，不会因为请求简单就按固定价扣。余额永不过期这一点同样关键，意味着你小额充值、慢慢验证节奏，不必担心过期带来的浪费。

跑通之后，把这条命令搬进代码即可：host、鉴权头和请求结构保持不变，只改 model 与 messages。59API 用一个账号、一个 key、一个主机承接多模型调用，第一次尝试的成本也足够低——先发一条 cURL，你会立刻得到答案。

Docs