DouDi 文档

Appearance

认证指南 ​

所有 API 请求都需要通过 API Key 进行身份认证。DouDi.ai 使用统一的 API Key，支持当前可用协议的认证方式。

获取 API Key ​

  1. 前往 DouDi.ai 控制台
  2. 进入 API Key 管理页面
  3. 点击创建 API Key
  4. 复制并安全保存你的 API Key

API Key 仅在创建时显示一次，请务必妥善保存。如果丢失，需要重新创建。

认证方式 ​

根据你使用的协议，认证方式略有不同：

OpenAI 兼容 ​

OpenAI 兼容协议使用 Authorization Header：

text
Authorization: Bearer <你的 DOUDI_API_KEY>
python
from openai import OpenAI

client = OpenAI(
    base_url="https://doudi.ai/v1",
    api_key="<你的 DOUDI_API_KEY>"
)

Anthropic 原生 ​

Anthropic 原生协议使用 x-api-key Header：

text
x-api-key: <你的 DOUDI_API_KEY>
text
import anthropic

client = anthropic.Anthropic(
    base_url="https://doudi.ai/v1",
    api_key="<你的 DOUDI_API_KEY>"
)

Grok / xAI 协议 ​

Grok / xAI 协议使用 Authorization Header。可直接通过 OpenAI SDK 指向 Grok / xAI Base URL：

text
Authorization: Bearer <你的 DOUDI_API_KEY>
python
from openai import OpenAI

client = OpenAI(
    base_url="https://doudi.ai/grok/v1",
    api_key="<你的 DOUDI_API_KEY>"
)

环境变量配置 ​

推荐使用 .env 或部署平台的环境变量管理 API Key，避免硬编码：

ini
DOUDI_API_KEY=<你的 DOUDI_API_KEY>

# 也可以设置协议专用的环境变量
OPENAI_API_KEY=<你的 DOUDI_API_KEY>
OPENAI_BASE_URL=https://doudi.ai/v1

ANTHROPIC_API_KEY=<你的 DOUDI_API_KEY>
ANTHROPIC_BASE_URL=https://doudi.ai/v1

GROK_API_KEY=<你的 DOUDI_API_KEY>
GROK_BASE_URL=https://doudi.ai/grok/v1

安全最佳实践 ​

  1. 使用环境变量 — 永远不要在代码中硬编码 API Key
  2. 定期轮换密钥 — 建议每 90 天更换一次
  3. 区分环境 — 开发和生产环境使用不同的 API Key
  4. 监控用量 — 定期检查 使用日志 和 数据看板 中的异常调用
  5. 限制权限 — 为不同项目创建独立的 API Key，便于追踪和管理

切勿将 API Key 提交到 Git 仓库或暴露在客户端代码中。使用 .gitignore 排除 .env 文件。