# Responses 格式

来源: https://docs.aicentos.com/api/chat/openai/responses

Language: zh-CN

> OpenAI Responses 风格的对话接口：端点、鉴权与调用示例

OpenAI Responses 风格的对话接口。

`POST /responses`

## 鉴权

Bearer Token：API Key 在控制台「令牌管理」获取，放在请求头 `Authorization`。

## 请求

`Content-Type: application/json`

```bash
export AICENTOS_API_KEY="sk-your-aicentos-api-key"

curl -X POST "https://aicentos.com/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -d '{
    "model": "gpt-5",
    "input": "用一句话介绍你自己"
  }'
```

`input` 可以直接传字符串，也可以传 OpenAI 官方的结构化消息数组，参数与官方一致。

## 响应

```json
{
  "id": "string",
  "object": "response",
  "status": "completed",
  "output": [],
  "usage": {}
}
```

鉴权失败时返回 `invalid_api_key` 错误，排查方法见[错误处理](https://docs.aicentos.com/billing/errors)：

```json
{
  "error": {
    "message": "Incorrect API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}
```