快速开始
注册账号、获取 API Key，并发出第一个请求。
三步开始#
发第一个请求#
安装 SDK：按你的语言三选一
bash
# Pythonpip install openai
# Node.jsnpm install openai
# Java (Maven)# <dependency># <groupId>com.openai</groupId># <artifactId>openai-java</artifactId># <version>4.50.0</version># </dependency>cURL
bash
curl https://ogrouter.ai/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://ogrouter.ai/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）
javascript
import OpenAI from 'openai';
const client = new OpenAI({ baseURL: 'https://ogrouter.ai/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);Java：与上面两段做同一件事
java
import com.openai.client.OpenAIClient;import com.openai.client.okhttp.OpenAIOkHttpClient;import com.openai.models.chat.completions.ChatCompletion;import com.openai.models.chat.completions.ChatCompletionCreateParams;
OpenAIClient client = OpenAIOkHttpClient.builder() .baseUrl("https://ogrouter.ai/v1") .apiKey(System.getenv("AIROUTER_API_KEY")) .build();
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder() .model("anthropic/claude-fable-5") .addUserMessage("用一句话解释什么是向量数据库") .build();
ChatCompletion resp = client.chat().completions().create(params);System.out.println(resp.choices().get(0).message().content().orElse(""));按模态选端点
上面是对话示例。图像见 `/docs/images`，视频见 `/docs/video`（OpenAI 或方舟协议），向量 / 重排见 `/docs/embeddings` 与 `/docs/rerank`。完整端点表在 平台介绍。
确认请求确实经由 AIRouter#
每个成功响应都带有一组 X-AiRouter-* 响应头，用于说明本次请求实际的处理情况。对账、灰度对比与故障报障都以它们为依据。
流式响应没有费用头
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://ogrouter.ai/v1", api_key="sk-ar-...")
# Anthropic SDK（注意没有 /v1）from anthropic import Anthropicclient = Anthropic(base_url="https://ogrouter.ai", api_key="sk-ar-...")不要用控制台的登录态调网关
控制台 JWT 与 API Key 是两套凭据，不通用。用 JWT 调推理端点会返回
invalid_credential。