文档不是说明书，是接入控制台。
覆盖鉴权、模型、Chat、Responses、Messages、余额、上传、图片任务、视频任务和错误码。示例域名统一为 https://api09.com/v1。
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":"你好"}]}'Key 只显示一次
数据库只保存 hash、前缀和尾号，前端不会出现上游密钥。
余额走 ledger
充值、扣费、退款和补偿都写明细，余额可追溯。
目标站计费口径
统一按 1 USD = 200 积分展示与预估，账户组价格后续可同步。
开始使用
快速开始
POST /v1/chat/completions把 SDK 的 base_url 改成 api09，替换为 api09 API Key，即可先用 OpenAI 兼容格式完成文本调用。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
开始使用
鉴权与 API Key
Authorization: Bearer / x-api-key / x-goog-api-key / Gemini ?key=API Key 只展示一次，服务端仅保存 hash 与尾号。OpenAI SDK 使用 Authorization: Bearer；Claude/Anthropic 客户端可用 x-api-key；Gemini /v1beta 客户端可用 x-goog-api-key 或 URL 参数 key/api_key。其他路径拒绝 URL Query Key，避免密钥进入访问日志。生产环境建议按项目创建不同 Key，并配置单日预算。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
开始使用
计费与积分
1 USD = 200 creditsapi09 按目标站汇率执行积分换算。余额变动全部写入 ledger，扣费在事务内结算，支持兑换码、后台加款、退款和补偿。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
开始使用
错误码
401 / 402 / 429 / 5xx对外错误会隐藏上游密钥、渠道和内部堆栈。客户端应对 429 和 5xx 做指数退避。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
文本模型
列出模型
GET /v1/models返回当前 API Key 可用模型、能力类型、端点和价格提示。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
文本模型
Chat Completions
POST /v1/chat/completions兼容 OpenAI Chat Completions，支持 stream、vision content blocks 和工具调用透传。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
文本模型
Responses API
POST /v1/responses面向新式 OpenAI Responses 工作流，支持服务端上下文、工具和多模态输入。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
文本模型
Anthropic Messages
POST /v1/messages使用 Anthropic 原生 Messages 结构调用 Claude 系列模型；支持 Authorization: Bearer 或 Anthropic 原生 x-api-key 鉴权。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
图像与视频
上传图片
POST /v1/uploads/images上传 JPEG/PNG/WebP/GIF 后返回 URL，用于 reference_images。单文件建议不超过 10MB。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
图像与视频
GPT-Image-2 图像生成
POST /v1/images/generations支持文生图和参考图生成；按 1K、2K、4K 展示最终单价与本次请求预估积分。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
图像与视频
图片生成任务
POST /v1/images/generations + GET /v1/images/tasks/:id图片生成会写入 TaskLog，可通过 /v1/images/tasks/:id 查询状态；在线体验里的图片任务也共用同一查询端点。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
图像与视频
上传视频
POST /v1/uploads/videos用于视频 remix、extend 或参考视频输入。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
图像与视频
视频生成
POST /v1/videos/generations统一接入 Sora、Veo、Seedance、Kling、Hailuo、Vidu、Wan 和 Grok Video；按任务或按秒显示费用预估。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
图像与视频
视频生成任务
POST /v1/videos/generations + GET /v1/videos/tasks/:id视频任务写入 TaskLog，控制台展示进度、上游任务 ID、失败原因和重试入口；查询端点按用户隔离返回任务状态。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
查询余额
GET /v1/balance返回 API Key 所属账户的积分余额、USD 等值、计费汇率；传 includeLedger=1 可返回最近 ledger 明细。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
Token 用量
GET /api/usage/token 或 /v1/dashboard/billing/usage兼容 NewAPI token_usage 结构，返回 Token 总额度、已用、剩余、每日预算、模型范围、过期时间和账户余额。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
兑换码充值
POST /api/redeem登录用户使用兑换码充值，成功时写 REDEEM ledger 和审计日志；停用、过期或超次数兑换码会被拒绝。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
后台账本调整
POST /api/admin/credit需要 user.sensitive_write，并需先完成 /api/verify 二次验证；可写入加款、退款或补偿 ledger，并记录 ADMIN_CREDIT 审计。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
后台兑换码
POST /api/admin/redeem-codes读取需要 redemption.read；创建/停用需要 redemption.sensitive_write 和 /api/verify。兑换码原文只返回一次；停用接口写审计并阻止后续兑换。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
后台用量日志
GET /api/admin/usage-logs后台全局用量检索支持 CSV、默认脱敏、sensitive=1 权限门和 adminInfo.billingAnomalies 扣费/流式断连异常标记。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
任务队列
POST /api/tasks + GET /api/tasks/:id登录用户可把文本、图片或视频任务放入队列。worker 领取 QUEUED 任务后调用 Bifrost/ToAPIs；控制台可查询详情、取消排队任务、重试失败任务。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。
账户与运营
审计日志
GET /api/admin/audit-logs登录、注册、Key、兑换码、后台加款、API 调用和任务事件都会写结构化审计日志。
接入注意
生产环境必须使用服务端代理或后端任务队列保存 api09 Key，浏览器代码只调用你自己的后端。