常见问题 FAQ
Oairegbox 是什么？
Oairegbox 是一个 OpenAI 兼容的 AI 模型聚合 API 网关：一个账号、一把令牌即可调用多家厂商的文本、图像、视频和音频模型，按量、按次或按秒计费。
What is Oairegbox? Oairegbox is an OpenAI-compatible AI model aggregation API gateway. One account and one API key call text, image, video and audio models from multiple vendors, billed per token, per call or per second.
API 的 Base URL 是什么？
主线路是 https://api.oairegbox.cc/v1，备用线路是 https://newapi.oairegbox.cc/v1。两条线路是同一个平台、同一个账号、同一个令牌和同一份余额，只是网络入口不同。
What is the API base URL? The primary endpoint is https://api.oairegbox.cc/v1 and the backup endpoint is https://newapi.oairegbox.cc/v1. Both are the same platform, account, key and balance; only the network entry differs.
支持哪些调用协议？
支持 OpenAI Chat Completions（/v1/chat/completions）、OpenAI Responses（/v1/responses）、Anthropic Messages（/v1/messages）、图像生成（/v1/images/generations）、异步视频（/v1/videos）和音频（/v1/audio/speech）。
Which API protocols are supported? OpenAI Chat Completions (/v1/chat/completions), OpenAI Responses (/v1/responses), Anthropic Messages (/v1/messages), Images (/v1/images/generations), async Videos (/v1/videos) and Audio (/v1/audio/speech).
怎么知道我的令牌能用哪些模型？
调用 GET /v1/models，返回的 data[].id 就是这把令牌可调用的模型，已按令牌、分组和模型限制过滤。不在列表里的模型对当前令牌不可用。
How do I know which models my key can use? Call GET /v1/models. The returned data[].id values are the models available to that key, already filtered by key, group and model limits.
调用失败会扣费吗？
不会。400、401、403、404、429 和 5xx 响应都不计费，只有成功（200）才扣费；异步任务失败会全额退回预扣。
Am I charged for failed calls? No. 400, 401, 403, 404, 429 and 5xx responses are not billed; only successful (200) calls are charged, and failed async tasks are fully refunded.
为什么充值后调用视频模型仍然返回 403？
异步与流式请求发起时会先做预扣冻结校验，要求账户可用余额和当前令牌可用额度都不低于本次预扣金额。按 Token 计费的 Seedance 视频会按上限预扣（约为实扣的 2 倍），出片后按实际用量结算并退回多余部分。可充值、把令牌设为无限额度，或调小视频秒数。
Why do I get 403 on video models after topping up? Async and streaming requests pre-authorize the expected cost; both the account balance and the key quota must cover it. Token-billed Seedance video pre-authorizes roughly 2x the final charge and refunds the difference after completion. Top up, set the key to unlimited quota, or request fewer seconds.
视频任务怎么查询结果？
提交后保留任务 ID，用 GET /v1/videos/{task_id} 每 3–5 秒轮询；状态为 queued、in_progress、completed、failed。客户端超时不代表任务失败，不要重复提交。
How do I get video results? Keep the task ID and poll GET /v1/videos/{task_id} every 3–5 seconds. Statuses are queued, in_progress, completed and failed. A client timeout does not mean the task failed; do not resubmit.
怎么查询余额和价格？
用 sk- 令牌调用 GET /api/usage/token/ 查询这把令牌的额度；额度单位除以 500000 即为人民币元。模型价格以控制台和模型广场为准，也可用 GET /api/pricing 程序化获取。
How do I check balance and prices? Call GET /api/usage/token/ with your sk- key to see its quota; divide quota units by 500000 to get CNY. Prices are shown in the console and model plaza, and via GET /api/pricing.
完整接口说明见 API 文档。