GPT-5.6 API

GPT-5.6 提供三个生产档位。三个模型均支持文本与图片输入、文本输出、流式响应、函数调用、结构化输出和可配置推理强度。

模型	适合场景	上下文	最大输出
`gpt-5.6-sol`	复杂专业任务、高难推理和质量优先的编码工作	1,050,000 Token	128,000 Token
`gpt-5.6-terra`	兼顾智能、延迟与成本的产品级工作负载	1,050,000 Token	128,000 Token
`gpt-5.6-luna`	大批量抽取、分类、路由与轻量 Agent	1,050,000 Token	128,000 Token

大多数生产任务可先从 gpt-5.6-terra 开始。只有在代表性评测显示质量收益明显时升级到 Sol；吞吐与成本优先时选择 Luna。

推荐：Responses API

新建推理与工具调用集成时，优先使用 Responses API。

1 import OpenAI from "openai";
2 
3 const client = new OpenAI({
4   apiKey: process.env.BEATAPI_API_KEY,
5   baseURL: "https://api.beatapi.io/v1"
6 });
7 
8 const response = await client.responses.create({
9   model: "gpt-5.6-terra",
10   input: "为支付 API 设计一套可靠的 Webhook 重试策略。",
11   reasoning: { effort: "medium" }
12 });
13 
14 console.log(response.output_text);

$ curl --request POST \
>   --url https://api.beatapi.io/v1/responses \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "gpt-5.6-terra",
>   "input": "Design a resilient webhook retry strategy for a payments API.",
>   "reasoning": {
>     "effort": "medium"
>   }
> }'

推理强度支持 none、low、medium、high、xhigh 和 max。可以用 medium 作为起点，再在真实任务上对比上下各一个档位。

兼容现有 SDK

迁移现有集成时，只需修改 Base URL，并将原有服务商密钥替换为 BeatAPI 密钥。

OpenAI Chat Completions

POST https://api.beatapi.io/v1/chat/completions

$ curl --request POST \
>   --url https://api.beatapi.io/v1/chat/completions \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "gpt-5.6-terra",
>   "messages": [
>     {
>       "role": "user",
>       "content": "Design a resilient webhook retry strategy for a payments API."
>     }
>   ]
> }'

Anthropic Messages

POST https://api.beatapi.io/v1/messages

可通过 x-api-key 或 Authorization: Bearer 发送 BeatAPI 密钥。

$ curl --request POST \
>   --url https://api.beatapi.io/v1/messages \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "gpt-5.6-terra",
>   "max_tokens": 1024,
>   "messages": [
>     {
>       "role": "user",
>       "content": "Design a resilient webhook retry strategy for a payments API."
>     }
>   ]
> }'

Gemini 兼容内容生成

POST https://api.beatapi.io/v1beta/models/{model}:generateContent

可通过 x-goog-api-key、Bearer 鉴权，或 Gemini SDK 兼容的 key 查询参数发送 BeatAPI 密钥。直接使用 HTTP 时优先选择请求头。

$ curl --request POST \
>   --url 'https://api.beatapi.io/v1beta/models/gpt-5.6-terra:generateContent' \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "contents": [
>     {
>       "role": "user",
>       "parts": [
>         {
>           "text": "Design a resilient webhook retry strategy for a payments API."
>         }
>       ]
>     }
>   ]
> }'

流式响应

按所选格式设置对应的流式字段。BeatAPI 不会转换 SSE 事件流，因此事件名和响应对象会保持该 SDK 格式的兼容性。

鉴权与可用模型

上线前先读取当前已启用的文本模型：

$ curl https://api.beatapi.io/v1/models \
>   -H "Authorization: Bearer $BEATAPI_API_KEY"

1 {
2   "object": "list",
3   "data": [
4     { "id": "gpt-5.6-terra", "object": "model", "owned_by": "beatapi" }
5   ]
6 }

同一个 API 密钥和 USD 余额可用于文本、图片、视频、工作流、特效和实时 API。文本调用按实际 Token 用量计量；可在 Dashboard 用量日志中查看请求 ID、模型、Token 总量、状态与结算金额。

生产检查清单

API 密钥只保存在可信服务端，并从日志中脱敏。
设置明确的请求超时，并安全处理流式响应断线重连。
保存响应请求 ID，便于支持与计费审计。
使用真实生产输入评测模型档位与推理强度。
分别处理 401、402、429、502 和 503。

继续使用媒体模型

同一个 BeatAPI 账户还可以调用 GPT Image 2、MiniMax H3、Seedance 2.5 以及其他图片与视频模型，无需新增另一套鉴权和计费系统。