快速开始
- 注册并完成邮箱验证。
- 控制台充值或兑换码入账。
- 「API 密钥」→ 创建 Key,分组按用途选择(见下表)。
- 客户端填 Base URL + Key,按对应章节配置模型名。
分组与路由(必读)
你在客户端里通常用 OpenAI 兼容格式发请求;小圆 API 收到后,会按模型族转成渠道真正需要的协议再转发。因此:分组要对、路径要对。对话走 /v1;生图 / 视频统一走 /api/v1/studio,Token 只选 生图组。
| 用途 | Key 分组 | 客户端路径 | 站内转发 |
|---|---|---|---|
| GPT / Codex | gpt-codex · gpt-codex-pro |
/v1/chat/completions · /v1/responses |
OpenAI 协议 |
| Claude | claude-max |
Anthropic 地址 或 /v1/chat/completions |
Anthropic 原生协议 |
| Gemini | Gemini · Gemini-Pro |
/v1/chat/completions |
Google Gemini 原生 |
| SVIP 专线 | svip专线 |
/v1/chat/completions · /v1/responses |
自定义 -svip 模型名,单独定价 |
| 生图 / 视频 | 生图组 |
/api/v1/studio |
创作台 API,按张/按秒扣费 |
Codex 配置
Codex 通常需要配置 config.toml 和 auth.json。配置完成后重启 Codex 生效。
配置文件位置
- Windows:
%USERPROFILE%\.codex\config.toml - Windows:
%USERPROFILE%\.codex\auth.json - macOS / Linux:
~/.codex/config.toml - macOS / Linux:
~/.codex/auth.json
model_provider = "WukongAPI" model = "gpt-5.6-sol" review_model = "gpt-5.6-sol" model_reasoning_effort = "medium" disable_response_storage = true network_access = "enabled" windows_wsl_setup_acknowledged = true approval_policy = "never" sandbox_mode = "danger-full-access" [model_providers.WukongAPI] name = "api.aixiaoyuan.work" base_url = "https://api.aixiaoyuan.work/v1" wire_api = "responses" requires_openai_auth = true
{
"OPENAI_API_KEY": "sk-替换为你的-小圆API-Key"
}
Key 分组选 gpt-codex 或 gpt-codex-pro。若要用其他模型,把 model 和 review_model 改成控制台中可用的模型名称即可。
切换模型
在 Codex 客户端内直接切换模型即可;config.toml、auth.json 与 Base URL 无需改动。可用模型名称以控制台「模型定价」为准。
Claude Code
Key 分组选 Claude 相关(如 claude-max)。配置完成后重启 Claude Code 生效。
配置文件位置
- Windows:
%USERPROFILE%\.claude\settings.json - macOS / Linux:
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aixiaoyuan.work/",
"ANTHROPIC_AUTH_TOKEN": "sk-替换为你的-小圆API-Key",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}
/v1/chat/completions。Gemini
客户端按 OpenAI 格式发对话,站内转 Google Gemini · Token 选 Gemini / Gemini-Pro · 与 生图组 不是同一 Key
https://api.aixiaoyuan.work/v1Authorization: Bearer sk-xxxGeminiGemini-Pro标准档 Gemini:3.5-flash · 3.1-pro · 3.1-pro-preview · Pro 档 Gemini-Pro:另含 3-flash-preview · 3-pro-preview
POST /v1/chat/completions→
识别 Gemini 分组→
Google Gemini 渠道
curl -X POST "https://api.aixiaoyuan.work/v1/chat/completions" \
-H "Authorization: Bearer sk-替换为你的-小圆API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash",
"messages": [{"role": "user", "content": "用一句话介绍你自己"}],
"max_tokens": 256,
"stream": true
}'
https://api.aixiaoyuan.work/v1,模型填上表名称。Function Calling 报错时,可先关闭工具调用试纯对话。SVIP 专线
与普通分组共用 /v1 入口;Token 选 svip专线,模型名须带 -svip 后缀(以控制台为准)
https://api.aixiaoyuan.work/v1Authorization: Bearer sk-xxxsvip专线-svipPOST /v1/chat/completions→
分组 svip专线→
模型填 xxx-svip
curl -X POST "https://api.aixiaoyuan.work/v1/chat/completions" \
-H "Authorization: Bearer sk-替换为你的-小圆API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.5-flash-svip",
"messages": [{"role": "user", "content": "你好"}],
"max_tokens": 256
}'
svip专线 时,模型不能填 gemini-3.5-flash 等无后缀名称;反之亦然。Codex 用 gpt-5.5-svip 时走 /v1/responses。单价见控制台「模型定价」。生图 / 视频
创作台 API · Token 选 生图组 · 异步提交后轮询拿图/成片
https://api.aixiaoyuan.work/api/v1/studioAuthorization: Bearer sk-xxx生图组GET /catalog→
POST /submit→
GET /poll?task_id=
→成品 url
/catalog 可匿名;/submit、/poll 须带 Token(无 Token 时 /poll 返回 401)。
curl -X POST "https://api.aixiaoyuan.work/api/v1/studio/submit" \
-H "Authorization: Bearer sk-替换为你的-小圆API-Key" \
-H "Content-Type: application/json" \
-d '{
"product_id": "image_nanoBanana2",
"wait": false,
"payload": {
"prompt": "白底电商主图,产品居中",
"size": "1K",
"aspectRatio": "1:1",
"urls": ["https://example.com/ref.jpg"]
}
}'
curl "https://api.aixiaoyuan.work/api/v1/studio/poll?task_id=任务ID" \ -H "Authorization: Bearer sk-替换为你的-小圆API-Key"
payload 字段:prompt 必填;其余参数见下表(与 /catalog 中 controls 的 key 一致);参考图 URL 填在 urls 等上传参数里,可省略。
生图模型规格
| product_id | 名称 | 价格 | 清晰度 / 分辨率 | 比例 | 参考图 |
|---|---|---|---|---|---|
image_nanoBanana2Lite |
NanoBanana 2 Lite | 0.12 元/张 | 1K | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9 | 最多 6 张(urls 数组) |
image_nanoBanana2 |
NanoBanana 2 | 0.15 元/张 | 1K / 2K / 4K | 同上 | 最多 14 张(urls 数组) |
image_nanoBanana_pro |
NanoBanana Pro | 0.45 元/张 | 1K / 2K / 4K | 同上 | 最多 6 张(urls 数组) |
image_nanoBanana |
NanoBanana | 0.15 元/张 | 1K(参数名 imageSize) |
同上 | 最多 6 张(urls 数组) |
image_gptImage2 |
GPT-Image-2 | 0.15 元/张 | — | auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21, 1:3, 3:1, 2:1, 1:2(参数名 size) |
最多 6 张(urls 数组) |
image_Wan27 |
Wan 2.7 图片 | 0.2 元/张 | 1280×1280、1104×1472、1472×1104、960×1696、1696×960 | — | 最多 4 张(urls 逗号分隔);可选 negative_prompt、seed、prompt_extend、watermark |
NanoBanana 系列清晰度参数名为 size(Classic 版为 imageSize),比例参数名为 aspectRatio。
视频模型规格
与上表相同 API:POST /submit + GET /poll,product_id 换为下表 ID;Token 仍选 生图组。视频按秒计费,扣费在任务成功出片时结算。
| product_id | 名称 | 价格 | 清晰度 | 比例 | 时长 | 参考素材 |
|---|---|---|---|---|---|---|
video_Wan27 |
Wan 2.7 视频 | 0.3 元/秒 | 720P / 1080P | 16:9, 9:16, 1:1, 4:3, 3:4 | 5 / 10 / 15 秒 | 可选首帧 firstFrameUrl;角色参考 urls(最多 5);音频 audio_url |
video_grok_imagine |
Grok Imagine | 0.15 元/秒 | — | 16:9, 9:16 | 6~15 秒 | 须参考图 image_urls(最多 4 张);不支持纯文生 |
video_google_omni |
Google Omni | 0.15 元/秒 | 720×1280 / 1280×720 / 1080×1920 / 1920×1080 | 随分辨率 | 10 秒 | 参考图 images(最多 7);参考视频 video(1 个) |
video_seedance |
Seedance 2.0 | 1.0 元/秒 | 720P / 480P | adaptive, 16:9, 9:16, 4:3, 1:1, 3:4, 21:9 | 4~15 秒 | 首尾帧、参考图/视频/音频(见 /catalog) |
video_omni |
可灵 Omni | 1.0 元/秒 | std / pro / 4K | 16:9, 9:16, 1:1 | 3~15 秒 | 参考图、首尾帧、参考视频(3~10 秒) |
video_vidu |
Vidu Q3 | 1.0 元/秒 | 540P / 720P / 1080P | 16:9, 9:16, 4:3, 3:4, 1:1 | 1~10 秒 | 主体图 subjects、参考图/视频 |
video_Sora2 |
Sora 2 | 0.15 元/秒 | small / large | 9:16, 16:9 | 4 / 8 / 12 秒 | 参考图 url(1 张);上游维护中,暂不可选 |
参考图/视频/音频须先上传至可公网访问的 URL(创作台页内上传,或自建存储)。上传接口:POST /api/v1/ai/test-page/upload-image(图)、upload-video(视频)、upload-audio(音频)。
常见问题
先查 分组与路由:Codex 别用 Claude / Gemini 分组;生图只用 生图组 + /api/v1/studio,不要走 /v1/chat/completions 或 /v1/images/generations。
确认分组为 Gemini 或 Gemini-Pro,模型用上方列表中的名称(如 gemini-3.5-flash)。
Token 分组必须是 生图组,Key 完整且未禁用,账户有余额。/poll 必须带 Authorization。
对话 / Codex / Claude / Gemini:https://api.aixiaoyuan.work/v1。生图:https://api.aixiaoyuan.work/api/v1/studio(与 /v1 不同路径,勿混填)。客户端会自动补 /v1 时,主站填 https://api.aixiaoyuan.work 即可。