响应头 — Markdown 源文

> **AI Agents**: 索引 `/api/llms.txt` | 英文全文 `/api/llms-full-en.txt` | 中文全文 `/api/llms-full-zh.txt` | OpenAPI `/api/openapi.yaml`
> Base URL: `<BASE_URL>/v1`

# 响应头

SupaNexus 在 API 响应中添加诊断头。

## 全局头

| 头 | 出现位置 | 说明 |
|----|----------|------|
| `X-SNX-Trace-ID` | 所有响应 | 本请求唯一 ID；联系支持时请提供 |

## Chat Completions 头

| 头 | 出现位置 | 说明 |
|----|----------|------|
| `X-SNX-Model` | `POST /v1/chat/completions` | 请求的逻辑模型 id |
| `X-SNX-Provider` | `POST /v1/chat/completions` | 实际提供推理的服务商标识 |

示例：

```http
HTTP/1.1 200 OK
Content-Type: application/json
X-SNX-Trace-ID: 7c9e6679-7425-40de-944b-e07fc1f90ae7
X-SNX-Model: deepseek/deepseek-chat
X-SNX-Provider: deepseek
```

## 配额响应

触发用量配额限制（429）时可能包含：

```http
Retry-After: 3600
```

值为建议等待秒数。

## CORS

浏览器允许的请求头：

- `Authorization`
- `Content-Type`
- `Accept-Language`
- `X-Locale`

## 幂等

`Idempotency-Key` 是**请求**头（非响应头）。见 [Chat Completions](./chat-completions.md)。

## 相关

- [Chat Completions](./chat-completions.md)
- [错误处理](./errors.md)