Responses（统一响应） - 数字先锋API文档

# Responses（统一响应） API 文档
接口 /v1/responses
本接口兼容 Responses API 调用方式，当前可用模型以平台实际配置为准，
常用包括：
gpt-5.3-codex：代码生成、代码解释、技术问答（推荐）
gpt-5 系列：通用对话、内容生成、总结改写
o 系列推理模型（如已开通）：复杂推理、步骤分析、数学与逻辑任务
包括gpt-5.4-pro  gpt涉及pro系统都建设使用此接口

### 按场景选模型：
客服场景优先用 gpt-5（稳定、通用、对话自然），写作场景优先用 gpt-5（表达质量高、改写总结好），编程场景优先用 gpt-5.3-codex（代码生成与调试能力更强），数据分析场景优先用 o 系列推理模型（多步骤分析与逻辑推断更稳）。

## 接口地址
`POST https://api.cxsee.com/v1/responses`

## 认证方式
请求头携带 Bearer Token：

```http
Authorization: Bearer YOUR_API_KEY
```
---

## 1) 最小可用示例

```bash
curl https://api.cxsee.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.3-codex",
    "input": "hello"
  }'
```

---

## 2) 中文提问示例

---

## 3) 返回结果说明（核心字段）

成功时会返回 JSON，常见字段如下：

- `id`：响应ID
- `object`：固定为 `response`
- `model`：实际使用模型
- `status`：如 `completed`
- `output`：模型输出内容（文本在 `output[].content[].text`）
- `usage`：token 用量统计（`input_tokens` / `output_tokens` / `total_tokens`）

---

## 4) 常见错误排查

- **401 Unauthorized**：API Key 无效或未传
- **400 Bad Request**：JSON 格式错误、缺少 `model` 或 `input`
- **429 Too Many Requests**：触发限流
- **5xx**：服务端异常，建议稍后重试

---

## 5) 使用建议

- `model` 必填，建议先使用：`gpt-5.3-codex`
- `input` 支持英文/中文自然语言
- 生产环境请在服务端保存 API Key，不要暴露到前端代码中

---

上一篇：sora 视频生成格式下一篇：Claude Messages（对话）