公开 API 总览

透明网关

顶级AI 不做 OpenAI、Anthropic、Gemini 之间的跨协议转换；gateway 只做鉴权、模型映射、上游认证替换、usage 回收和账务审计所需的最小处理。

模型目录

/v1/models 返回当前用户可见、可调度的公开模型入口。公开模型名是用户请求中的模型名，不等同于上游 provider 的完整模型清单。

当前公开 gateway 路径包括 GET /v1/models、POST /v1/chat/completions、POST /v1/responses、POST /v1/messages、POST /v1/messages/count_tokens、GET /v1beta/models、POST /v1beta/models/{model}:generateContent 和 POST /v1beta/models/{model}:streamGenerateContent。

本页只做入口级摘要；完整字段、请求/响应、错误码和兼容细节以当前 API 契约和 Go 后端代码为准。

Prop

Type

Chat Completions

Chat Completions 请求至少包含 model 和 messages；stream 可选，设置为 true 时仍由 Go gateway 回收 usage 并完成账务审计。

Prop

Type

POST /v1/chat/completions

curl https://dingjiai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_USER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "public-model",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

流式 Chat Completions 会由后端处理 usage 回收和计费审计所需字段；客户端不应在前端绕过 Go gateway 直连 provider。