OpenAI 兼容 API 手册

Chat 模型调用

兼容 OpenAI Chat Completions，同时在网关层记录余额、用量、错误映射和上游 request id。

POST /v1/chat/completions

Chat

curl https://api09.com/v1/chat/completions \
  -H "Authorization: Bearer sk-api09_xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"你好"}]}'

请求字段

字段	类型	说明
model	string	模型 ID，例如 claude-sonnet-4-6 或 gpt-5-4。
messages	array	OpenAI 兼容 messages。
stream	boolean	可选，是否启用流式响应。

响应与计费

字段	类型	说明
choices	array	兼容 OpenAI SDK 的输出结构。
usage	object	token 用量和积分估算。
x-request-id	header	排查日志与上游错误使用。
X-RateLimit-Backend	header	429 时返回 redis、memory 或 redis_unavailable；生产环境 Redis 不可用会 fail closed。

积分统一换算：1 USD = 200 积分。

生产检查

无 Key 返回 401

余额不足返回 402

限流返回 429 并带 Retry-After、X-RateLimit-*、X-RateLimit-Backend

生产环境设置 API09_RATE_LIMIT_REQUIRE_REDIS=1

在线体验列出模型