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

# Authentication

> 用 Bearer Token 调用 DimiLinks 全部 API。

DimiLinks 所有接口共用同一把 Bearer 密钥。请求按协议族选择 base URL：

* OpenAI 兼容协议：`https://dimilinks.com/v1`
* Anthropic 原生协议：`https://api-direct.dimilinks.com/`

请求头：

```http theme={null}
Authorization: Bearer <DIMILINKS_API_KEY>
Content-Type: application/json
```

## 示例

```bash theme={null}
# OpenAI 兼容入口
curl "https://dimilinks.com/v1/models" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY"

# Anthropic 原生入口
curl "https://api-direct.dimilinks.com/v1/messages" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

## 安全建议

* 密钥保存在服务端的环境变量、Secrets Manager 或 KMS，不要写进前端源码或客户端安装包。
* 让终端用户发起请求时，由你的服务端转发，不要把密钥透出给浏览器。
* 仓库 `.env` 文件加入 `.gitignore`；别把密钥贴进截图或日志。
* 发现泄露后，立即在控制台禁用旧密钥并新建一把。

## 用官方 SDK 直连

DimiLinks 与 OpenAI、Anthropic 官方 SDK 协议兼容，把 base URL 指过来即可。

OpenAI Python SDK：

```python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://dimilinks.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
```

Anthropic Python SDK：

```python theme={null}
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-...",
    base_url="https://api-direct.dimilinks.com/",
)

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
```

<Note>
  Anthropic SDK 的 `base_url` 指到 `https://api-direct.dimilinks.com/` 即可；SDK 内部会自动拼接 `/v1/messages`。
</Note>

## 图片 / 视频结果链接

* 图片签名链接形如 `/p/img/...`，使用 URL 自带的过期时间和签名参数访问，**不**需要再附带 Bearer。
* 视频结果链接形如 `/v1/videos/{task_id}/content`，**需要**用 Bearer 访问；可以代理回你的服务端再下发。
* 如果链接已过期，请重新查询任务。