> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neural4d.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 通用请求头

> API v1 接口共用的认证和请求追踪请求头。

## Authorization

每个请求都需要使用 Bearer 方式发送 API 密钥。

```http theme={null}
Authorization: Bearer ${YOUR_API_KEY}
```

## X-Request-Id

`X-Request-Id` 为可选请求头，用于关联客户端日志和 Neural4D 日志。客户端传入合法值时，服务会原样使用，并在响应头中返回相同的值。未传入或值不合法时，服务会生成新值并在响应头中返回。

支持长度为 `1-128` 个 ASCII 字符，仅允许英文字母（`A-Z`、`a-z`）、数字（`0-9`）、点号（`.`）、下划线（`_`）和连字符（`-`）。例如 `client-request-123`、`order_20260804.1`。

```http theme={null}
X-Request-Id: client-request-123
```

| 请求头             | 方向    | 说明                             |
| --------------- | ----- | ------------------------------ |
| `Authorization` | 请求    | 必填，使用 Bearer 方式发送 API 密钥。      |
| `X-Request-Id`  | 请求和响应 | 可选的请求 ID；合法的客户端值会原样返回，否则由服务生成。 |