请求基础
Base URL 与鉴权
Base URL、用户 API Key 和鉴权方式。
所有协议都使用顶级AI用户 API Key
客户端只需要持有用户 API Key。上游 provider Key 由顶级AI在服务端转发时使用，不应该出现在客户端配置、curl 示例或公开文档里。
Base URL 怎么填
不同客户端对 Base URL 的拼接方式不一样。原则是：如果工具会自动补 /v1/chat/completions、/v1/responses 或 /v1/messages，Base URL 就填到它要求的位置；如果你直接写 HTTP 请求，就按下面的公开路径调用。
| 协议 | 常用 Base URL | 公开路径 |
|---|---|---|
| OpenAI Chat Completions | https://dingjiai.com/v1 | POST /v1/chat/completions，兼容 POST /chat/completions |
| OpenAI Responses | https://dingjiai.com/v1 | POST /v1/responses |
| OpenAI Chat 模型列表 | https://dingjiai.com/v1 | GET /v1/models，兼容 GET /models |
| Anthropic Messages | https://dingjiai.com | POST /v1/messages 或 POST /anthropic/v1/messages |
| Anthropic 模型列表 | https://dingjiai.com | GET /anthropic/v1/models |
| Gemini GenerateContent | https://dingjiai.com | POST /v1beta/models/{model}:generateContent |
| Gemini streamGenerateContent | https://dingjiai.com | POST /v1beta/models/{model}:streamGenerateContent |
| Gemini 模型列表 | https://dingjiai.com | GET /v1beta/models |
本文列出的公开路径兼容无尾随 / 和有尾随 /；接入文档和示例统一写无尾随 / 的形式。
更多接口
| 接口 | 常用 Base URL | 路径 | 说明 |
|---|---|---|---|
| OpenAI Images Generations | https://dingjiai.com/v1 | POST /v1/images/generations | 图片生成，按实际返回图片数量结算 |
| Anthropic Count Tokens | https://dingjiai.com | POST /v1/messages/count_tokens 或 POST /anthropic/v1/messages/count_tokens | Anthropic Messages 子接口，不扣费结算 |
| Images Edits | 不作为公开 API Base URL 使用 | POST /api/img/edits | 站内网页登录态私有入口，不开放 /v1/images/edits |
鉴权方式
OpenAI-compatible 入口使用 Bearer 鉴权。
-H "Authorization: Bearer YOUR_USER_API_KEY"Anthropic 入口使用 x-api-key 鉴权。
-H "x-api-key: YOUR_USER_API_KEY"Gemini 原生入口推荐使用 x-goog-api-key 鉴权。
-H "x-goog-api-key: YOUR_USER_API_KEY"鉴权边界
Prop
Type
最后更新于