GPT-5.6 Luna API
GPT-5.6 家族轻量款,响应迅捷、成本更低,适合高并发与快速问答。
- 模型名:
gpt-5.6-luna - 厂商: OpenAI
- 类型: chat
POST /v1/responses
gpt-5.6-luna:Responses 响应,含必填项、嵌套响应和虚构示例。
基础调用
必填参数: model, input
可用参数: model, input, instructions, max_output_tokens, stream, store
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|
model | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选: gpt-5.6-luna |
input | array | 是 | 输入消息列表;也可使用单个文本字符串。 |
instructions | string | 否 | 可选的系统级说明。 |
max_output_tokens | integer | 否 | 可选输出长度限制;思考内容的返回与占用按型号约定。 |
stream | boolean | 否 | 是否使用 SSE 增量响应。 |
store | boolean | 否 | 是否请求保存响应供后续使用;支持情况依型号。 |
## 使用与响应约定
- 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。
- 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。
- 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。
- 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。
- 生成文件请及时保存;不要假设结果链接永久有效。
### 多轮与流式
基础示例是单次非流式调用。多轮调用需要保留本协议要求的历史消息;工具调用时应把调用标识与工具结果配对后再发下一轮。流式调用应按协议解析完整SSE事件,不能把任意一个网络分块当成完整JSON;检查最终事件或结束原因。可将已支持的stream选项设为true读取流式结果。
## 参考
参数术语参考[OpenAI Responses官方说明](https://developers.openai.com/api/reference/resources/responses/methods/create);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。
## 完整嵌套字段说明
数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。
### 请求头
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `Content-Type` | string | 是 | 请求体格式为application/json。 |
### 请求体
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:gpt-5.6-luna |
| `input` | array[object] | 是 | 输入消息列表;也可使用单个文本字符串。 |
| `input[].role` | string | 是 | 输入消息角色。 可选值:user, assistant, system, developer |
| `input[].content` | array[object] | 是 | 输入内容块。 |
| `input[].content[].type` | string | 是 | 内容块类型。 可选值:input_text |
| `input[].content[].text` | string | 是 | 输入文本。 |
| `instructions` | string | 否 | 可选的系统级说明。 |
| `max_output_tokens` | integer | 否 | 可选输出长度限制;思考内容的返回与占用按型号约定。 |
| `stream` | boolean | 否 | 是否使用 SSE 增量响应。 默认:false |
| `store` | boolean | 否 | 是否请求保存响应供后续使用;支持情况依型号。 默认:false |
### 响应 200
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `id` | string | 否 | 响应标识。 |
| `object` | string | 否 | 对象类型 response。 |
| `created_at` | integer | 否 | 创建时间,Unix 秒。 |
| `status` | string | 否 | 响应状态;检查 completed、incomplete 或 failed。 |
| `model` | string | 否 | 响应型号。 |
| `output` | array[object] | 否 | 输出项列表;文本通常位于 message 的 content。 |
| `output[].id` | string | 否 | 输出项标识。 |
| `output[].type` | string | 否 | 输出项类型,可能为 message、reasoning 或工具调用。 |
| `output[].role` | string | 否 | 消息角色。 |
| `output[].status` | string | 否 | 输出项状态。 |
| `output[].content` | array[object] | 否 | 消息内容块。 |
| `output[].content[].type` | string | 否 | 内容类型,如 output_text。 |
| `output[].content[].text` | string | 否 | 正文。 |
| `output[].content[].annotations` | array[object] | 否 | 正文的附加注释。 |
| `output[].call_id` | string | 否 | 函数调用关联标识。 |
| `output[].name` | string | 否 | 函数名称。 |
| `output[].arguments` | string | 否 | JSON 编码参数。 |
| `usage` | object | 否 | 本次响应的用量。 |
| `usage.input_tokens` | integer | 否 | 输入 Token。 |
| `usage.input_tokens_details` | object | 否 | 输入分项。 |
| `usage.input_tokens_details.cached_tokens` | integer | 否 | 缓存命中,属于输入。 |
| `usage.output_tokens` | integer | 否 | 输出 Token,可能包含思考。 |
| `usage.output_tokens_details` | object | 否 | 输出分项。 |
| `usage.output_tokens_details.reasoning_tokens` | integer | 否 | 思考分项,不与已包含它的输出重复相加。 |
| `usage.total_tokens` | integer | 否 | 服务端报告的总量。 |
| `error` | object | 否 | 失败时的错误对象,成功时可能为 null。 |
| `error.message` | string | 否 | 错误说明。 |
| `error.code` | string | 否 | 错误码。 |
### 错误响应结构
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `error` | object | 否 | 错误详情;以本次返回为准。 |
| `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 |
| `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 |
| `error.code` | string | 否 | 错误码,可能为空。 |
请求示例
curl --request POST https://api.router.ai/v1/responses \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"model": "gpt-5.6-luna",
"input": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Describe a fictional blue paper boat in one sentence."
}
]
}
],
"stream": false,
"store": false
}'