快速开始

从注册到第一个成功的请求，通常五分钟。

三步开始#

1
注册账号
邮箱注册即可，不需要企业资质，注册后立刻可用：注册。
2
创建 API Key
在 API 令牌页创建。明文只显示一次，请当场保存；服务端只存前缀与哈希，丢了只能重建。
3
把 base_url 指向 AIRouter
现有 OpenAI SDK 的其他代码不用动，model 换成目录里的模型名即可。

发第一个请求#

cURL

bash

curl https://ai.oceango.hk/v1/chat/completions \  -H "Authorization: Bearer $AIROUTER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "anthropic/claude-fable-5",    "messages": [{"role": "user", "content": "用一句话解释什么是向量数据库"}]  }'

Python（openai SDK）

python

import osfrom openai import OpenAI
client = OpenAI(    base_url="https://ai.oceango.hk/v1",    api_key=os.environ["AIROUTER_API_KEY"],)
resp = client.chat.completions.create(    model="anthropic/claude-fable-5",    messages=[{"role": "user", "content": "用一句话解释什么是向量数据库"}],)print(resp.choices[0].message.content)

Node.js（openai SDK）

typescript

import OpenAI from 'openai';
const client = new OpenAI({  baseURL: 'https://ai.oceango.hk/v1',  apiKey: process.env.AIROUTER_API_KEY,});
const resp = await client.chat.completions.create({  model: 'anthropic/claude-fable-5',  messages: [{ role: 'user', content: '用一句话解释什么是向量数据库' }],});console.log(resp.choices[0]?.message.content);

怎么确认它真的走了 AIRouter#

每个成功响应都带一组 X-AiRouter-* 头。对账、灰度对比与报障都靠它们，不用去猜这次请求落到了哪里。

响应头	含义
`X-Request-Id`	本次请求的唯一标识。报障请提供它，也可以在调用日志里直接搜到明细。
`X-AiRouter-Model`	实际服务本次请求的标准 slug。用了别名、变体或降级链时以它为准。
`X-AiRouter-Group`	实际命中的分组，也就是这次走的是哪一档线路。
`X-AiRouter-Region`	处理本次请求的区域。
`X-AiRouter-Attempts`	实际尝试次数。大于 1 表示中途换过线路。
`X-AiRouter-Cost`	本次扣费金额（USD 字符串）。仅非流式。
`X-AiRouter-Balance`	扣费后的余额。仅非流式。
`X-AiRouter-Insured`	命中零完成保险时才有，值是豁免原因：`empty_completion` / `upstream_error` / `content_filtered` / `client_abort`。仅非流式。
`X-AiRouter-Usage-Estimated`	为 `true` 表示用量是本地估算的（上游没返回）。仅非流式。

流式响应没有费用头

SSE 的响应头必须在第一帧之前发出，那时还没结算，所以流式响应上不会有 X-AiRouter-Cost / X-AiRouter-Balance / X-AiRouter-Insured。流式请求的费用请查调用日志，或在请求里带 stream_options.include_usage，用流末尾的用量帧自己算。

从 OpenRouter 迁过来的话，X-Provider / X-Cost / X-Attempts 这三个别名头也会一起发，老代码不用改。

SDK 与工具#

两家官方 SDK 都只需要改 base_url 与 api_key。注意 Anthropic SDK 用的是不带 /v1 的根地址——它自己会拼上 /v1/messages。

python

# OpenAI SDKfrom openai import OpenAIclient = OpenAI(base_url="https://ai.oceango.hk/v1", api_key="sk-ar-...")
# Anthropic SDK（注意没有 /v1）from anthropic import Anthropicclient = Anthropic(base_url="https://ai.oceango.hk", api_key="sk-ar-...")

不要用控制台的登录态调网关

控制台 JWT 与 API Key 是两套凭据，不通用。用 JWT 调推理端点会返回 invalid_credential。

下一步#

对话补全
全部请求字段、流式输出与与 OpenAI 的差异。
模型与路由
变体、降级链与 provider 偏好。
错误码与排查
该重试哪些、不该重试哪些。
浏览模型
看看目录里有哪些模型、价格与可用率。

快速开始

从注册到第一个成功的请求，通常五分钟。

三步开始#

1
注册账号
邮箱注册即可，不需要企业资质，注册后立刻可用：注册。
2
创建 API Key
在 API 令牌页创建。明文只显示一次，请当场保存；服务端只存前缀与哈希，丢了只能重建。
3
把 base_url 指向 AIRouter
现有 OpenAI SDK 的其他代码不用动，model 换成目录里的模型名即可。

发第一个请求#

cURL

bash

curl https://ai.oceango.hk/v1/chat/completions \  -H "Authorization: Bearer $AIROUTER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "anthropic/claude-fable-5",    "messages": [{"role": "user", "content": "用一句话解释什么是向量数据库"}]  }'

Python（openai SDK）

python

import osfrom openai import OpenAI
client = OpenAI(    base_url="https://ai.oceango.hk/v1",    api_key=os.environ["AIROUTER_API_KEY"],)
resp = client.chat.completions.create(    model="anthropic/claude-fable-5",    messages=[{"role": "user", "content": "用一句话解释什么是向量数据库"}],)print(resp.choices[0].message.content)

Node.js（openai SDK）

typescript

import OpenAI from 'openai';
const client = new OpenAI({  baseURL: 'https://ai.oceango.hk/v1',  apiKey: process.env.AIROUTER_API_KEY,});
const resp = await client.chat.completions.create({  model: 'anthropic/claude-fable-5',  messages: [{ role: 'user', content: '用一句话解释什么是向量数据库' }],});console.log(resp.choices[0]?.message.content);

怎么确认它真的走了 AIRouter#

每个成功响应都带一组 X-AiRouter-* 头。对账、灰度对比与报障都靠它们，不用去猜这次请求落到了哪里。

响应头	含义
`X-Request-Id`	本次请求的唯一标识。报障请提供它，也可以在调用日志里直接搜到明细。
`X-AiRouter-Model`	实际服务本次请求的标准 slug。用了别名、变体或降级链时以它为准。
`X-AiRouter-Group`	实际命中的分组，也就是这次走的是哪一档线路。
`X-AiRouter-Region`	处理本次请求的区域。
`X-AiRouter-Attempts`	实际尝试次数。大于 1 表示中途换过线路。
`X-AiRouter-Cost`	本次扣费金额（USD 字符串）。仅非流式。
`X-AiRouter-Balance`	扣费后的余额。仅非流式。
`X-AiRouter-Insured`	命中零完成保险时才有，值是豁免原因：`empty_completion` / `upstream_error` / `content_filtered` / `client_abort`。仅非流式。
`X-AiRouter-Usage-Estimated`	为 `true` 表示用量是本地估算的（上游没返回）。仅非流式。

流式响应没有费用头

从 OpenRouter 迁过来的话，X-Provider / X-Cost / X-Attempts 这三个别名头也会一起发，老代码不用改。

SDK 与工具#

两家官方 SDK 都只需要改 base_url 与 api_key。注意 Anthropic SDK 用的是不带 /v1 的根地址——它自己会拼上 /v1/messages。

python

# OpenAI SDKfrom openai import OpenAIclient = OpenAI(base_url="https://ai.oceango.hk/v1", api_key="sk-ar-...")
# Anthropic SDK（注意没有 /v1）from anthropic import Anthropicclient = Anthropic(base_url="https://ai.oceango.hk", api_key="sk-ar-...")

不要用控制台的登录态调网关

控制台 JWT 与 API Key 是两套凭据，不通用。用 JWT 调推理端点会返回 invalid_credential。

下一步#

对话补全
全部请求字段、流式输出与与 OpenAI 的差异。
模型与路由
变体、降级链与 provider 偏好。
错误码与排查
该重试哪些、不该重试哪些。
浏览模型
看看目录里有哪些模型、价格与可用率。