文本模型进阶用户更新于
POST/v1/responses
GPT-6.1 Terra
请求 ID gpt-6.1-terra
协议
POST /v1/responses· OpenAI Responses示例
认证
请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。
Authorization: Bearer YOUR_API_KEY
请求参数
POST /v1/responses
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | 填写模型 ID gpt-6.1-terra。 |
input | string / object[] | 必填 | 输入文本，或按顺序排列的输入项数组。消息项使用 role 和 content。 |
instructions | string | 选填 | 模型应遵循的指令，用于设定任务和输出要求。 |
max_output_tokens | integer | 选填 | 输出 token 的上限。可用上限因模型和接入点而异。 |
stream | boolean | 选填 | true 请求 SSE 流式响应，false 请求普通 JSON。以所选接入点支持的模式为准。 |
store | boolean | 视条件 | 支持此字段时，false 请求不保留此响应以供后续检索。 |
text.format | object | 视条件 | 结构化输出使用 text.format，例如 type: json_schema。只在所选接入点支持该格式时使用。 |
temperature | number | 视条件 | 控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。 |
top_p | number | 视条件 | 按累计概率限制采样候选。仅在所选模型和接入点支持时使用。 |
reasoning.effort | string | 视条件 | 请求的推理强度。有效档位和是否能关闭推理取决于模型及所选接入点。 |
tools | object[] | 视条件 | 供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。 |
tool_choice | string / object | 视条件 | 控制工具选择。强制或指定工具只在所选接入点明确支持时使用。 |
请求示例
先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。
OpenAI Responses
bash
curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "gpt-6.1-terra",
"instructions": "You are a helpful assistant.",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain how a rainbow forms in one sentence."
}
]
}
],
"stream": true,
"store": false
}'
读取响应
- OpenAI Responses · 流式响应中，从
response.output_text.delta事件的delta字段拼接文本，并处理完成与失败事件。 SSE
能力与限制
streaming· 支持tool_calling· 支持image_input· 未公开承诺video_input· 不支持