DouDi 文档

Appearance

API 概览 ​

DouDi.ai 提供三种协议的 API 接入方式，覆盖 OpenAI 兼容、Anthropic 原生和 Grok / xAI 协议。

协议推荐： OpenAI 协议推荐使用 Responses API，原生 Prompt Caching 支持更优；调用 Claude 模型推荐使用 Anthropic 原生协议；调用 Grok 模型推荐使用 Grok / xAI 协议，其文本 JSON/SSE 形状兼容 xAI 的 OpenAI-compatible 格式。

API 文档结构 ​

OpenAI 兼容协议

适合 OpenAI SDK、Responses API、Chat Completions、Codex Web Search、模型列表和图像生成。

Anthropic 原生协议

适合 Claude Messages、Anthropic SDK、原生 Claude 参数和模型列表。

Grok / xAI 协议

适合 Grok Chat Completions、Responses 和 Grok 模型查询。

DouDi OpenAPI

适合余额查询、实时价格查询和平台级工具集成。

Base URL ​

协议Base URL说明
OpenAI 兼容https://doudi.ai/v1兼容 OpenAI SDK，支持 Chat Completions 和 Responses API
Anthropic 原生https://doudi.ai/v1兼容 Anthropic SDK，原生 Claude 体验
Grok / xAI 协议https://doudi.ai/grokGrok / xAI 路由，文本 JSON/SSE 兼容 xAI OpenAI-compatible 格式

认证 ​

所有协议使用统一的 DouDi.ai API Key，但 Header 格式因协议而异：

协议Header格式
OpenAIAuthorizationBearer sk-xxx
Anthropicx-api-keysk-xxx
Grok / xAIAuthorizationBearer sk-xxx

详见 认证指南。

可用端点 ​

OpenAI 兼容协议 ​

端点方法说明
/v1/chat/completionsPOST创建对话补全
/v1/responsesPOST创建模型响应（Responses API，推荐）
/v1/alpha/searchPOSTCodex standalone web search，详见 Web Search
/v1/images/generationsPOST图像生成
/v1/modelsGET列出所有可用模型
/v1/models/{provider}GET按供应商过滤模型
/v1/models/{provider}/{model_id}GET获取模型详情
/v1/models/countGET获取模型数量统计

Anthropic 原生协议 ​

端点方法说明
/v1/messagesPOST创建 Messages（推荐）
/v1/modelsGET列出所有可用模型
/v1/models/{provider}GET按供应商过滤模型
/v1/models/{provider}/{model_id}GET获取模型详情
/v1/models/countGET获取模型数量统计

Grok / xAI 协议 ​

端点方法说明
/grok/v1/chat/completionsPOST创建 Grok 对话补全，详见 Chat Completions
/grok/v1/responsesPOST创建 Grok Responses API 响应，详见 Responses
/grok/v1/modelsGET列出可用 Grok 模型，详见 Models
/grok/v1/models/{model_id}GET获取指定 Grok 模型详情

DouDi.ai OpenAPI（平台） ​

与协议无关的平台接口，鉴权方式见各端点文档。

端点方法说明
/v1/user/balanceGET余额查询，兼容 cc-switch，使用 DouDi.ai API Key 鉴权
doudi.ai/api/provider/pricingGET实时价格查询，hvoy 兼容，HMAC 签名或公开访问

速率限制 ​

DouDi.ai 按量付费，所有用户共享统一的速率策略，无套餐差异：

限制项额度
RPM（请求/分钟）100（团队级聚合）
TPM（Token/分钟）不限

RPM 按团队聚合计算，多 Key 共享同一配额。如需更高速率配额，请联系 DouDi 运营支持 申请调整。详见 Rate Limits。

当触发限流时，API 返回 429 Too Many Requests，响应 Header 包含：

text
HTTP/1.1 429 Too Many Requests
x-ratelimit-limit-requests: 100
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 60s

错误码 ​

所有协议返回统一的 HTTP 状态码：

状态码说明常见原因
200成功—
400请求错误参数格式错误、缺少必填字段
401认证失败API Key 无效或过期
403权限不足账户无权访问该模型
404资源不存在模型 ID 错误
429触发限流超过速率限制
500服务器错误内部错误，请重试
502上游错误模型供应商服务异常
503服务不可用服务维护中

错误响应格式 ​

json
{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

DouDi.ai 扩展参数 ​

DouDi.ai 在标准协议基础上提供扩展参数，用于高级路由和回退控制：

json
{
  "model": "<MODEL_ID>",
  "messages": [{ "role": "user", "content": "Hello" }],
  "provider": {
    "routing": "latency",
    "fallback": [
      "<FALLBACK_MODEL_ID_1>",
      "<FALLBACK_MODEL_ID_2>"
    ]
  }
}

详见 供应商路由 和 故障回退。