平台介绍

一个 key、一套端点，调用全目录模型。

AIRouter 把多家供应商的对话、图像、向量、重排与视频模型，收拢到同一套兼容接口之下。你不必为每家上游单独对接一次：沿用现有的 OpenAI 或 Anthropic SDK，只把 base_url 指向 AIRouter、把 api_key 换成平台签发的密钥，原有代码即可继续运行。选路、失败换线与用量记账由平台在后台完成。

概览#

同一批模型有两个入口：既可以用 OpenAI SDK 调用 Claude，也可以用 Anthropic SDK 调用 GPT。两个入口共用同一套路由、计费、限流与日志。

端点	协议	鉴权头
`POST /v1/chat/completions`	OpenAI Chat Completions	`Authorization: Bearer sk-ar-...`
`POST /v1/messages`	Anthropic Messages	`x-api-key: sk-ar-...`（也认 Bearer）
`POST /v1/completions`	OpenAI Completions（遗留）	同上；新项目请用 chat
`POST /v1/images/generations`	OpenAI Images（同步）	同上
`POST /v1/embeddings`	OpenAI Embeddings	同上
`POST /v1/rerank`	重排（OpenAI 协议）	同上
`POST /v1/videos`	OpenAI Videos（异步）	同上
`POST /api/v3/contents/generations/tasks`	火山方舟视频原生协议（异步，可多参考图）	同上；SDK base 指 `{origin}/api/v3`
`GET /v1/models`	OpenAI Models（附模态与能力字段）	同上，必填

三种鉴权头等价，全部推理端点通用（含 /api/v3/... 视频协议）：Authorization: Bearer（OpenAI SDK 与 curl）、x-api-key（Anthropic SDK）、api-key（Azure 风格）。推理 Key 一律以 sk-ar- 开头。

服务地址。Anthropic 官方 SDK 要的是不带 /v1 的根地址。

bash

# OpenAI 兼容（大多数情况用这个）export OPENAI_BASE_URL=https://ogrouter.ai/v1
# Anthropic SDKexport ANTHROPIC_BASE_URL=https://ogrouter.ai

平台能做什么#

统一推理接口
对话、图像、向量、重排与视频共用 sk-ar- API Key；换模型只需改 model。
图像生成
POST /v1/images/generations 同步出图，按实际返回张数计费。
向量与重排
/v1/embeddings 与 /v1/rerank 可接入检索增强生成（RAG）。
异步视频生成
/v1/videos（OpenAI）与 /api/v3/contents/generations/tasks（火山方舟）共用任务链路与计费；多参考图、首尾帧请走方舟协议。
可编程路由
单次请求可用 provider 声明路由偏好：原厂优先、价格优先、限定区域、拒绝训练用途等。
自动降级与熔断
同一模型可以挂多条线路。请求超时或报错时自动改走下一条；某条线路连续失败会被熔断，探测恢复后重新纳入候选。
零完成保险
零产出不计费：各用量项均为 0。
账单可核对
每次调用都能查到线路、单价、倍率与折扣，账单可自行复算。

和直连供应商的差别#

一个 key 覆盖全部模型，不用为每家上游各申请一次、各管一套配额与账单。
同一模型通常接入多条线路。某条线路出现抖动或故障时，请求会自动改走备用线路，你的线上服务不受单条线路波动的影响。
路由策略是可编程的：合规要求、价格上限、区域限制都能写在单次请求里，而不是只能接受平台的默认策略。
响应头会返回本次实际使用的模型、通道分组、区域与费用，便于对账与灰度对比；精确到具体线路的路由轨迹记录在调用日志中。
零产出不计费：空回复与全部候选线路失败的请求都不会产生费用。

在控制台中试用#

控制台的 Playground 支持在不编写代码的情况下试用各个模型：选中视频模型时，参数面板会自动切换为视频参数，并给出可直接运行的代码片段。

下一步#

快速开始
从注册到发出第一个成功的请求。
模型与路由
模型名语法、变体、降级链与 provider 偏好。
计费口径
公式、预扣与实结、零完成保险。
错误码
统一封装、全部错误码与重试策略。

概览#

同一批模型有两个入口：既可以用 OpenAI SDK 调用 Claude，也可以用 Anthropic SDK 调用 GPT。两个入口共用同一套路由、计费、限流与日志。

端点	协议	鉴权头
`POST /v1/chat/completions`	OpenAI Chat Completions	`Authorization: Bearer sk-ar-...`
`POST /v1/messages`	Anthropic Messages	`x-api-key: sk-ar-...`（也认 Bearer）
`POST /v1/completions`	OpenAI Completions（遗留）	同上；新项目请用 chat
`POST /v1/images/generations`	OpenAI Images（同步）	同上
`POST /v1/embeddings`	OpenAI Embeddings	同上
`POST /v1/rerank`	重排（OpenAI 协议）	同上
`POST /v1/videos`	OpenAI Videos（异步）	同上
`POST /api/v3/contents/generations/tasks`	火山方舟视频原生协议（异步，可多参考图）	同上；SDK base 指 `{origin}/api/v3`
`GET /v1/models`	OpenAI Models（附模态与能力字段）	同上，必填

服务地址。Anthropic 官方 SDK 要的是不带 /v1 的根地址。

bash

# OpenAI 兼容（大多数情况用这个）export OPENAI_BASE_URL=https://ogrouter.ai/v1
# Anthropic SDKexport ANTHROPIC_BASE_URL=https://ogrouter.ai

平台能做什么#

统一推理接口

对话、图像、向量、重排与视频共用 sk-ar- API Key；换模型只需改 model。

图像生成

POST /v1/images/generations 同步出图，按实际返回张数计费。

向量与重排

/v1/embeddings 与 /v1/rerank 可接入检索增强生成（RAG）。

异步视频生成

/v1/videos（OpenAI）与 /api/v3/contents/generations/tasks（火山方舟）共用任务链路与计费；多参考图、首尾帧请走方舟协议。

可编程路由

单次请求可用 provider 声明路由偏好：原厂优先、价格优先、限定区域、拒绝训练用途等。

自动降级与熔断

同一模型可以挂多条线路。请求超时或报错时自动改走下一条；某条线路连续失败会被熔断，探测恢复后重新纳入候选。

零完成保险

零产出不计费：各用量项均为 0。

账单可核对

每次调用都能查到线路、单价、倍率与折扣，账单可自行复算。

和直连供应商的差别#

一个 key 覆盖全部模型，不用为每家上游各申请一次、各管一套配额与账单。

同一模型通常接入多条线路。某条线路出现抖动或故障时，请求会自动改走备用线路，你的线上服务不受单条线路波动的影响。

路由策略是可编程的：合规要求、价格上限、区域限制都能写在单次请求里，而不是只能接受平台的默认策略。

响应头会返回本次实际使用的模型、通道分组、区域与费用，便于对账与灰度对比；精确到具体线路的路由轨迹记录在调用日志中。

零产出不计费：空回复与全部候选线路失败的请求都不会产生费用。