GPT Chat Completions

用一个 BeatAPI 密钥，通过同一个 OpenAI Chat Completions 端点调用 GPT-6.1 Sol、GPT-6 Astra、GPT-6 Sol 和 GPT-6 Luna。

• 一个端点 POST /v1/chat/completions 覆盖当前所有 GPT 模型，改 model 即可切换。
• 支持文本与图片输入、文本输出、流式输出、函数调用、结构化输出和可配置的推理强度。
• 兼容 OpenAI SDK：改 base URL，换成 BeatAPI 密钥即可。
• 新的推理和工具调用集成，推荐使用 OpenAI Responses。

在调试窗口里打开本接口，填入你的 BeatAPI API 密钥即可发送。调用是真实的，费用从你自己的余额中扣除。

模型

把下列 ID 之一作为 model 发送。它们是各自独立的模型，不是互相的别名。

• 价格为基础档，已计入折扣。长上下文档、缓存命中输入价和缓存写入价不在本表内，见价格表。
• — 表示目录未公布该数字。

本系列仍可调用的旧 ID 见旧型号。

快速开始

在服务端安装 openai 包，把密钥放在 BEATAPI_API_KEY，不要把它写进浏览器代码。以下是请求示例，不是真实的模型输出记录。

从 choices[0].message.content 读取答案，再检查 finish_reason 和 usage。HTTP 200 不能证明答案满足你的任务，请在应用里校验内容。文本请求直接返回，不要为它们轮询 /v1/tasks。

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

端点与鉴权

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

请求参数

接受标准的 OpenAI Chat Completions 字段。请求格式兼容并不意味着每个模型厂商特有的选项或工具都受支持，请测试你依赖的选项。

响应

非流式调用返回一个 JSON 对象。以下是节选示例。

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "gpt-6-luna",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Retry with exponential backoff and jitter, and make every handler idempotent."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 16,
    "total_tokens": 35
  }
}

响应字段

流式输出

设置 "stream": true。BeatAPI 原样转发服务端推送事件流，不做转换，事件对象与 OpenAI SDK 保持兼容。

• 响应类型是 text/event-stream；不流式时是 application/json。
• 调用模型之前发生的失败，会以带 HTTP 状态码的普通 JSON 错误返回，而不是流事件。
• 设置明确的超时，并安全地重连流式响应。

data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Retry"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" with backoff"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

错误

HTTP 错误速查

认证、路由、限速和未知模型这几类失败发生在调用模型之前，返回 BeatAPI 信封：error.code、error.message、retryable、request_id。其余失败保持 OpenAI SDK 格式 {"error": {"message", "type", "code"}}：错误码在 error.code，request id 附在 message 末尾。详见错误码。

完整的错误码表和重试策略见错误码。

注意事项

• GPT 模型也可在 OpenAI Responses 上调用。
• 输入超过 27.2 万 tokens 时，gpt-6.1-sol 和 gpt-6-astra 对整个请求使用更高的档位。规划长上下文负载前请查看价格表。
• 密钥只放在可信的服务端，记录响应里的请求 ID，只对 429、500 和 503 重试。