GPT88 Agent Docs
ChatOpenAI主推模型1 家上游

gpt-5.6-terra

GPT-5.6 预览系列主力档，平衡质量、速度与成本，适合作为业务默认候选。

在 gpt88.cc 获取 API Key快速开始

模型概览

  • GPT-5.6 Terra 可作为 GPT-5.6 预览系列的主力平衡档理解：比最高档更适合常规业务落地，同时保留 GPT-5.6 系列的新能力方向。
  • 它适合产品化接入、SaaS 助手、内部工作流和多轮对话场景。实际能力边界、参数支持和费用仍以控制台为准。
  • 围绕 OpenAI 官方 X 帖的公开讨论焦点，通常会落在“默认该选 Sol 还是 Terra”“成本能否接受”“是否适合生产灰度”这些问题上。

适用场景

  • 需要比轻量模型更强的推理和稳定性，但不希望每个请求都使用最高档模型时
  • 需要 OpenAI 兼容 SDK、工具调用、结构化输出和流式响应的常规业务场景时
  • 需要作为客服、知识库、业务助手、内容生成或内部 Agent 的默认候选时
  • 希望先体验 GPT-5.6 系列，同时控制单次调用成本和延迟时

接入说明

  • OpenAI 兼容工具可使用 https://api.gpt88.cc，并把请求体 model 设置为 gpt-5.6-terra。
  • 建议把 Terra 作为默认候选，把 Sol 作为复杂任务升级路径，把 Luna 作为高频轻量任务路径。
  • 如果接入 Cursor、OpenCode、Codex CLI、ChatBox 或自研服务，配置方式与其他 GPT 模型一致，只需替换 model。
  • 生产接入前建议准备一组固定评测样本，比较 gpt-5.6-terra、gpt-5.5、gpt-5.4 的质量和成本。

使用提醒

  • 该模型属于新上 preview 口径，参数、权限和价格可能随平台配置变化。
  • 不要只根据模型名决定路由；应该按任务复杂度、失败成本、延迟和预算做分层。
  • 如果遇到工具调用或 JSON 输出不稳定，先缩小 prompt、减少工具数量，再考虑升级到 Sol。

能力标签

GPT-5.6 previewfunction callingJSON Mode流式响应

推荐场景

  • 产品默认模型
  • SaaS 集成
  • 工作流自动化
  • 多轮助手

接口路径

POSThttps://api.gpt88.cc/v1/chat/completions

该路径由模型分类决定：Chat / Image / Video / Audio 使用不同 endpoint，同一分类内通常只需要替换 model 字段。

请求需在 Header 中携带 Authorization: Bearer <API_KEY>。 完整字段说明见 Chat Completions API 。

API 文档

Endpoint
POST /v1/chat/completions
Model ID
gpt-5.6-terra
Content-Type
application/json
接口类型
OpenAI 兼容对话补全接口，支持非流式和流式输出
Base URL
OpenAI SDK / Cursor / cURL 用 https://api.gpt88.cc。

Headers / 鉴权

  • Authorizationstring必填
    使用 Bearer <GPT88_API_KEY>。API Key 在 gpt88.cc 控制台创建。
  • Content-Typestring必填
    请求体格式。音频转写上传文件时使用 multipart/form-data。
    默认值：application/json
  • Acceptstring
    非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。
    默认值：application/json 或 text/event-stream

Chat 协议差异

Chat 模型不只看模型名，还要看你使用的客户端协议。Claude Code / Anthropic SDK 和 OpenAI SDK 拼出来的路径不同。

OpenAI 兼容推荐
Base URL
https://api.gpt88.cc
Endpoint
POST /v1/chat/completions
Body
{ "model": "gpt-5.6-terra", "messages": [...] }
Anthropic / Claude
Base URL
https://api.gpt88.cc
Endpoint
POST /v1/messages
Body
{ "model": "gpt-5.6-terra", "messages": [...] }

这个模型更适合优先走 OpenAI 兼容协议；只有当目标工具明确支持 Claude 风格接入时，才使用 Anthropic 路径。

请求参数

以下字段按当前模型分类生成。价格、上下文长度、限速、可用线路等动态信息以 gpt88.cc 控制台为准。

  • modelstring必填
    当前模型 ID：gpt-5.6-terra。复制时请保持大小写一致。
  • messagesarray<Message>必填
    多轮对话历史。每条消息包含 role 和 content。
  • streamboolean
    是否使用 SSE 流式返回。适合聊天界面和长回答。
    默认值：false
  • temperaturenumber
    采样温度，值越高越发散。正式业务建议先固定后再调优。
    默认值：1
  • max_tokensinteger
    本次生成的最大 token 数。模型上下文边界以控制台为准。
  • response_formatobject
    结构化输出配置，例如 { "type": "json_object" }。
  • toolsarray<Tool>
    Function calling 工具定义。是否支持取决于具体模型和账号配置。

响应字段

响应结构保持 OpenAI 兼容风格；媒体类模型可能返回异步任务 ID 或资源 URL。

  • idstring必填
    本次补全的唯一 ID，便于排障关联日志。
  • objectstring必填
    固定为 chat.completion 或流式 chunk 类型。
  • modelstring必填
    实际承担推理的模型 ID。
  • choicesarray<Choice>必填
    生成结果数组，包含 message、delta 或 finish_reason。
  • usageobject
    Token 用量统计。流式请求可能在结束包或非流式响应中返回。

状态码

  • 200OK必填
    请求成功，响应体结构见上方响应字段。
  • 400Bad Request
    请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
  • 401Unauthorized
    API Key 缺失、无效或格式错误。
  • 404Not Found
    Endpoint 或模型不存在。请确认路径为 /v1/chat/completions，模型 ID 为 gpt-5.6-terra。
  • 429Rate Limited
    触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
  • 5xxUpstream Error
    上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

错误与排查

  • 401：检查 Authorization 是否为 Bearer <API_KEY>，以及 Key 是否仍有效。
  • 404：检查 endpoint 是否为 /v1/chat/completions，以及模型名 gpt-5.6-terra 是否在控制台可见。
  • 429：触发限速或余额不足时，降低并发、缩短请求，或到控制台查看额度。
  • 5xx：保持统一 Base URL 重试，并记录请求 ID 方便排障。

请求示例

curl https://api.gpt88.cc/v1/chat/completions \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "user", "content": "用一句话介绍 gpt88.cc"}
    ]
  }'

期望响应（精简示例）：

200 OKjson
{
  "id": "chatcmpl-gpt-5-6-",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gpt-5.6-terra",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": { "role": "assistant", "content": "..." }
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 64, "total_tokens": 88 }
}