# 932.ai

> 一站式 AI 网关 — 一个 API Key 统一调用 OpenAI / Claude / Gemini / AWS Bedrock / 通义千问 / 字节豆包 等主流大模型, OpenAI 兼容协议, 实时计费, 覆盖 文本对话/图像生成/视频生成/向量嵌入/语音 全模态.

> Unified AI gateway — one API key for OpenAI, Anthropic Claude, Google Gemini, AWS Bedrock, Alibaba Qwen, ByteDance Doubao and 100+ other models. OpenAI-compatible protocol, real-time usage billing, covering chat, image, video, embedding and speech.

## 接入方式 (How to integrate)

- API Base (OpenAI 兼容 / OpenAI-compatible): https://api.router.ai/v1
- MCP (AI agent 自动发现+调用 / agent-native, 官方 MCP Registry `ai.router/ai-gateway`): https://mcp.router.ai/mcp
- OpenAPI 规范 (machine-readable spec, 含鉴权定义): https://www.932.ai/openapi.json
- MCP 发现清单 (discovery manifest): https://www.932.ai/.well-known/mcp.json
- Agent 接入指南 (agent integration guide): https://www.932.ai/AGENTS.md
- 注册获取 API Key (sign up): https://www.932.ai/register

语言版本 (language versions): [zh-Hans](https://www.932.ai/) · [zh-Hant](https://www.932.ai/zh-hant) · [en](https://www.932.ai/en)

## Quick start (copy-paste)

Get an API key at https://www.932.ai/register — then use any OpenAI-compatible client.

### curl

```bash
curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"dola-seed-2-0-pro","messages":[{"role":"user","content":"Hello"}]}'
```

### Python (official OpenAI SDK — only base_url changes)

```python
from openai import OpenAI

client = OpenAI(api_key="sk-...", base_url="https://api.router.ai/v1")
resp = client.chat.completions.create(
    model="dola-seed-2-0-pro",  # or glm-5.3, claude-fable-5 ...
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
```

### MCP (AI agents — zero integration code)

`932.ai` is on the official MCP Registry as `ai.router/ai-gateway`. Add this to any MCP client (Claude Desktop / Cursor / Cline / your own agent):

```json
{
  "mcpServers": {
    "router": {
      "type": "http",
      "url": "https://mcp.router.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${ROUTER_API_KEY}"
      }
    }
  }
}
```

The MCP server exposes tools for chat / image / video / speech / transcription plus live resources for the model catalog, pricing and API reference.

## API 文档 (API reference)

- [Kimi K3 (长程编程 / 推理)](https://www.932.ai/docs/api/kimi-k3-chat): `POST /v1/chat/completions` — Kimi K3 是月之暗面旗舰模型, 1M token 上下文, 始终开启思考模式, 面向长程编程与端到端知识工作. OpenAI 兼容 /v1/chat/completions.
- [查询视频任务](https://www.932.ai/docs/api/get-video-task): `GET /v1/videos/generations/{id}` — 按任务 ID 查看生成进度与结果 URL
- [Gemini 视频理解](https://www.932.ai/docs/api/gemini-video): `POST /v1/chat/completions` — 把视频 URL 传给 Gemini, 可做内容摘要 / 分镜描述 / 问答 / 字幕生成
- [BytePlus Seedream + SeedEdit 图像生成](https://www.932.ai/docs/api/byteplus-seedream): `POST /v1/images/generations` — Seedream 5.0 Pro / 5.0 Lite / 4.5 / 4.0 文生图 + 图生图 + 多图连续生成, 兼容 OpenAI SDK
- [Grok Imagine 图像生成 (文生图 / 图生图)](https://www.932.ai/docs/api/xai-grok-imagine-image): `POST /v1/images/generations` — xAI Grok Imagine 图像生成, OpenAI 兼容接口. 支持文生图 (t2i) 与图生图 (i2i).
- [Gemini 音频理解](https://www.932.ai/docs/api/gemini-audio): `POST /v1/chat/completions` — 把音频 URL 作为 user 消息传给 Gemini, 可做转写 / 摘要 / 翻译 / 问答
- [OpenAI GPT Image 图生图 (i2i)](https://www.932.ai/docs/api/openai-gpt-image-edit): `POST /v1/images/edits`
- [Gemini Banana 图像生成 (Nano Banana)](https://www.932.ai/docs/api/gemini-banana-image): `POST /v1/images/generations` — Google Gemini 系列同步图像生成 (T2I / I2I / 多图合成 / 多轮编辑, 原生 Interactions API 格式)
- [Grok Imagine 视频生成 (异步)](https://www.932.ai/docs/api/xai-grok-imagine-video): `POST /v1/videos/generations` — xAI Grok Imagine 视频生成, 异步任务. 提交返回任务 ID, 轮询查询状态获取视频 URL.
- [提交视频任务](https://www.932.ai/docs/api/submit-video-task): `POST /v1/videos/generations` — 异步文生 / 图生视频, 支持 Seedance 全系
- [Gemini 聊天 (含多模态)](https://www.932.ai/docs/api/gemini-chat): `POST /v1/chat/completions` — 通过统一端点调用 Gemini 2.x / 3.x 全系, 支持文本 + 图像多模态输入与 thinking
- [OpenAI GPT Image 图像生成](https://www.932.ai/docs/api/openai-gpt-image): `POST /v1/images/generations` — GPT Image 系列文生图 (gpt-image-2 / 1.5 / 1), 兼容 OpenAI SDK
- [创建消息请求 (Claude 原生)](https://www.932.ai/docs/api/create-claude-message): `POST /v1/messages` — Anthropic Claude 原生消息格式, 兼容官方 SDK 与工具链
- [查询额度](https://www.932.ai/docs/api/get-billing-subscription): `GET /v1/dashboard/billing/subscription` — 返回当前 Key 的额度信息
- [Seedance 视频生成 (详细)](https://www.932.ai/docs/api/seedance-video-detailed): `POST /v1/videos/generations` — Seedance 全系列深度参数: 首尾帧 / 参考视频 / 参考图 / 音频生成 / Draft 模式 / Seed 复现
- [Aliyun HappyHorse 视频生成](https://www.932.ai/docs/api/aliyun-happyhorse-video): `POST /v1/videos/generations` — Aliyun HappyHorse 异步 t2v/i2v/r2v 视频生成 (≤9 图参考)
- [Claude Code 接入配置教程](https://www.932.ai/docs/api/claude-code-setup): `POST /v1/messages` — Claude Code (官方 CLI) 通过两个环境变量指向我方网关, 直接使用全部 Claude / Bedrock 模型
- [Aliyun Qwen-Image 文生图](https://www.932.ai/docs/api/aliyun-qwen-image): `POST /v1/images/generations` — Qwen-Image / Plus / 2.0 / Max / Edit 系列文生图, 同步返回 OSS URL (24h 有效)
- [推理对话 (Reasoning Models)](https://www.932.ai/docs/api/create-reasoning-completion): `POST /v1/chat/completions` — GPT-5.4 Pro / GPT-5 Pro 等推理模型, 适用于数学 / 逻辑 / 代码场景
- [创建对话请求 (OpenAI 兼容)](https://www.932.ai/docs/api/create-chat-completion): `POST /v1/chat/completions` — 兼容 OpenAI Chat Completions 协议, 一套接口调用 Claude / Gemini 等主流大模型

## 模型 (共 129 个 / 129 models, 节选 top 30)

价格为对外单价 (USD), 完整目录见 llms-full.txt / pricing is per-unit USD.

- [Dola Seed 2.0 Pro](https://www.932.ai/models/dola-seed-2-0-pro) (`dola-seed-2-0-pro` · `chat` · BytePlus) — $0.5/1M in · $3/1M out: BytePlus Ark · ByteDance Seed 2.0 Pro (视觉多模态, 分档计价 128K/256K)
- [Dola Seed 2.1 Turbo](https://www.932.ai/models/dola-seed-2-1-turbo) (`dola-seed-2-1-turbo` · `chat` · BytePlus) — $0.5/1M in · $2.5/1M out: BytePlus Ark · ByteDance Seed 2.1 Turbo (视觉多模态)
- [Seedance 2.5](https://www.932.ai/models/dreamina-seedance-2.5) (`dreamina-seedance-2.5` · `video` · bytedance) — $9.63–$5.76/1M video tokens: dreamina-seedance-2.5 视频生成, 480p / 720p, 最长支持 30 秒
- [GLM-5.3](https://www.932.ai/models/glm-5.3) (`glm-5.3` · `chat` · Zhipu) — $0.77/1M in · $2.42/1M out: 智谱最新旗舰模型，1M 上下文，擅长 coding 与 agent 任务，支持思考长度控制
- [Claude Fable 5](https://www.932.ai/models/claude-fable-5) (`claude-fable-5` · `chat` · Anthropic) — $7/1M in · $35/1M out: Anthropic Claude Fable 5 — Mythos-class 旗舰
- [Claude Sonnet 5](https://www.932.ai/models/claude-sonnet-5) (`claude-sonnet-5` · `chat` · Anthropic) — $1.4/1M in · $7/1M out: Anthropic 新一代 Sonnet, 编码 / Agent 性能接近旗舰 opus-4-8 而价格不到一半, 1M 上下文, 高性价比
- [HappyHorse 1.1 T2V](https://www.932.ai/models/happyhorse-1.1-t2v) (`happyhorse-1.1-t2v` · `video` · HappyHorse) — from $0.084/秒: 快马1.1 文生视频, 输入文本 → 视频, 720p/1080p
- [Claude Opus 5](https://www.932.ai/models/claude-opus-5) (`claude-opus-5` · `chat` · Anthropic) — $3.5/1M in · $17.5/1M out: Anthropic 旗舰 Claude Opus 5
- [Claude Opus 4.8](https://www.932.ai/models/claude-opus-4-8) (`claude-opus-4-8` · `chat` · Anthropic) — $3.5/1M in · $17.5/1M out: Anthropic 最新旗舰, SWE-Bench/OSWorld/Agent 优于 4.7
- [GPT-5.6 Luna](https://www.932.ai/models/gpt-5.6-luna) (`gpt-5.6-luna` · `chat` · OpenAI) — $0.65/1M in · $3.9/1M out: GPT-5.6 家族轻量款，响应迅捷、成本更低，适合高并发与快速问答。
- [GPT-5.6 Terra](https://www.932.ai/models/gpt-5.6-terra) (`gpt-5.6-terra` · `chat` · OpenAI) — $1.625/1M in · $9.75/1M out: GPT-5.6 家族均衡款，性能与成本兼顾，适合日常主力任务的可靠之选。
- [GPT-5.6 Sol](https://www.932.ai/models/gpt-5.6-sol) (`gpt-5.6-sol` · `chat` · OpenAI) — $3.25/1M in · $19.5/1M out: GPT-5.6 家族旗舰款，性能最强，擅长复杂推理、长文本与高质量创作，追求极致质量的首选。
- [GPT-5.5](https://www.932.ai/models/gpt-5.5) (`gpt-5.5` · `chat` · OpenAI) — $3.25/1M in · $19.5/1M out: flagship 2026-04, Tier 5+ quota
- [Seedream 5.0 Pro](https://www.932.ai/models/dola-seedream-5-0-pro-260628) (`dola-seedream-5-0-pro-260628` · `image` · BytePlus) — from $0.04275/张: seedream-5.0-pro是字节跳动发布的最新图像创作模型，支持图生图，文生图
- [Seedance 2.0](https://www.932.ai/models/dreamina-seedance-2-0-260128) (`dreamina-seedance-2-0-260128` · `video` · bytedance) — $6.3–$3.87/1M video tokens: 文生/图生视频, 多分辨率档位, 适合高质量创作
- [Seedance 2.0 Fast](https://www.932.ai/models/dreamina-seedance-2-0-fast-260128) (`dreamina-seedance-2-0-fast-260128` · `video` · bytedance) — $5.04–$2.97/1M video tokens: Seedance 2.0 快速档, 速度优先, 适合批量生成
- [Seedance 2.0 Mini](https://www.932.ai/models/dreamina-seedance-2-0-mini-260615) (`dreamina-seedance-2-0-mini-260615` · `video` · bytedance) — $3.15–$1.89/1M video tokens: Seedance 2.0 快速档, 速度优先, 适合批量生成
- [HappyHorse 1.1 I2V](https://www.932.ai/models/happyhorse-1.1-i2v) (`happyhorse-1.1-i2v` · `video` · HappyHorse) — from $0.084/秒: 快马1.1 图生视频, 输入图+文本 → 视频, 720p/1080p
- [HappyHorse 1.1 R2V](https://www.932.ai/models/happyhorse-1.1-r2v) (`happyhorse-1.1-r2v` · `video` · HappyHorse) — from $0.084/秒: 快马1.1 多图参考生视频, 最多9张参考图 → 主体一致性视频
- [Wan 2.7 T2V](https://www.932.ai/models/wan2.7-t2v) (`wan2.7-t2v` · `video` · Wan) — from $0.07/秒: 万相 2.7 文生视频, 720p/1080p
- [Wan 2.7 I2V](https://www.932.ai/models/wan2.7-i2v) (`wan2.7-i2v` · `video` · Wan) — from $0.07/秒: 万相 2.7 图生视频, 支持音频输入, 720p/1080p
- [Wan 2.7 R2V](https://www.932.ai/models/wan2.7-r2v) (`wan2.7-r2v` · `video` · Wan) — from $0.07/秒: 万相 2.7 参考生视频, 最强 5 个图/视频/音频混合参考
- [Wan 2.7 T2V (2026-04-25)](https://www.932.ai/models/wan2.7-t2v-2026-04-25) (`wan2.7-t2v-2026-04-25` · `video` · Wan) — from $0.07/秒: 万相 2.7 文生视频 dated 版
- [Wan 2.7 I2V (2026-04-25)](https://www.932.ai/models/wan2.7-i2v-2026-04-25) (`wan2.7-i2v-2026-04-25` · `video` · Wan) — from $0.07/秒: 万相 2.7 图生视频 dated 版
- [HappyHorse 1.0 T2V](https://www.932.ai/models/happyhorse-1.0-t2v) (`happyhorse-1.0-t2v` · `video` · HappyHorse) — from $0.098/秒: 快马1.0 文生视频, 输入文本 → 视频, 720p/1080p
- [HappyHorse 1.0 I2V](https://www.932.ai/models/happyhorse-1.0-i2v) (`happyhorse-1.0-i2v` · `video` · HappyHorse) — from $0.098/秒: 快马1.0 图生视频, 输入图+文本 → 视频, 720p/1080p
- [HappyHorse 1.0 R2V](https://www.932.ai/models/happyhorse-1.0-r2v) (`happyhorse-1.0-r2v` · `video` · HappyHorse) — from $0.098/秒: 快马1.0 多图参考生视频, 最多9张参考图 → 主体一致性视频
- [HappyHorse 1.0 Video Edit](https://www.932.ai/models/happyhorse-1.0-video-edit) (`happyhorse-1.0-video-edit` · `video` · HappyHorse) — from $0.098/秒: 快马1.0 视频编辑, 自然语言指令 + 最多 5 张参考图, 720p/1080p (上游 function=video-edit, body 必传 input.video_url)
- [DeepSeek-V4-Pro](https://www.932.ai/models/deepseek-v4-pro) (`deepseek-v4-pro` · `chat` · DeepSeek) — $1.32/1M in · $2.64/1M out: 旗舰级 MoE 大模型 (1.6T 总参 / 49B 激活), 原生百万级上下文, 顶尖推理 + 代码 + 长文本
- [DeepSeek-V4-Flash](https://www.932.ai/models/deepseek-v4-flash) (`deepseek-v4-flash` · `chat` · DeepSeek) — $0.11/1M in · $0.22/1M out: 高效轻量化 MoE (284B 总参 / 13B 激活), 百万上下文, 高并发低延迟, 适合 RAG / 内容创作

## 帮助中心 (Help center, 共 16 篇 / articles)

入口 / index: https://www.932.ai/help

- **新手入门** (https://www.932.ai/help/c/getting-started) — 注册、拿到密钥、发出第一个请求
  - [5 分钟发出第一个请求](https://www.932.ai/help/quickstart): 注册账号 → 创建令牌 → 用任意 OpenAI 兼容客户端调用。
  - [接入地址与鉴权方式](https://www.932.ai/help/base-url-and-auth): base_url 该填什么、Bearer 与 x-api-key 两种头的区别。
- **接入教程** (https://www.932.ai/help/c/integration) — 各类客户端、SDK 与开发工具的接入方法
  - [在 OpenAI SDK 中使用](https://www.932.ai/help/openai-sdk): Python / Node 官方 SDK 只需改一个参数。
- **编程接入** (https://www.932.ai/help/c/coding) — 在 IDE、编辑器插件和命令行编程工具里接入本平台
  - [在 Cline 中接入](https://www.932.ai/help/cline-setup): VS Code 的 Cline 插件：选 OpenAI Compatible，填三个值即可。
  - [在 Cursor 中接入](https://www.932.ai/help/cursor-setup): Cursor IDE：覆盖 OpenAI Base URL，并把模型名手动加进模型列表。
  - [在 Claude Code 中接入](https://www.932.ai/help/claude-code-setup): 两个环境变量即可，Claude Code 走 Anthropic 原生协议。
  - [在 Kilo Code 中接入](https://www.932.ai/help/kilo-code-setup): VS Code / Cursor 上的 Kilo Code 插件，配置方式与 Cline 同源。
  - [在 Codex CLI 中接入](https://www.932.ai/help/codex-cli-setup): 改 ~/.codex/config.toml，新增一个指向本平台的 provider。
  - [在 Gemini CLI 中接入](https://www.932.ai/help/gemini-cli-setup): Gemini CLI 走 Google 原生协议，本平台提供同款原生端点。
  - [在 OpenCode CLI 中接入](https://www.932.ai/help/opencode-cli-setup): 在 opencode 配置文件里加一个 openai-compatible provider。
  - [在 Trae IDE 中接入](https://www.932.ai/help/trae-ide-setup): Trae 的自定义模型入口，填 OpenAI 兼容地址即可。
  - [在 CC Switch 中接入](https://www.932.ai/help/cc-switch-setup): 用 CC Switch 管理多个 Claude Code 接入配置，一键切换。
- **计费与充值** (https://www.932.ai/help/c/billing) — 计费口径、充值方式、账单与发票
  - [计费是怎么算的](https://www.932.ai/help/how-billing-works): 按 token 实际用量计费，失败请求的处理规则。
  - [充值方式与到账时间](https://www.932.ai/help/top-up-methods): USDT-TRC20 与信用卡两种方式，到账规则与常见卡点。
- **模型与能力** (https://www.932.ai/help/c/models) — 支持的模型、上下文长度、多模态能力
  - [怎么选模型](https://www.932.ai/help/choosing-a-model): 按任务类型、上下文长度和价格三个维度筛。
- **故障排查** (https://www.932.ai/help/c/troubleshooting) — 报错码含义与常见问题的定位思路
  - [常见报错码怎么读](https://www.932.ai/help/error-codes): 401 / 402 / 404 / 429 / 5xx 分别代表什么、先查什么。


## 完整目录 (Full catalog)

- [全部 129 个模型 + 定价 / full model list with pricing](https://www.932.ai/llms-full.txt)
- [模型广场 / model hub](https://www.932.ai/models)
- [价格总览 / pricing](https://www.932.ai/pricing)
- [API 文档 / API docs](https://www.932.ai/docs/api)
- [帮助中心 / help center](https://www.932.ai/help)
- [站点地图 / sitemap](https://www.932.ai/sitemap.xml)