小圆 API 小圆 API Docs
WUKONG API · DOCS

从注册到接入,一页完成所有配置

注册 → 充值 → 创建 Key → 按分组接入客户端。用户侧统一填 https://api.aixiaoyuan.work/v1;站内按模型族转发到匹配的渠道协议。

API 地址https://api.aixiaoyuan.work/v1

快速开始

  1. 注册并完成邮箱验证。
  2. 控制台充值或兑换码入账。
  3. 「API 密钥」→ 创建 Key,分组按用途选择(见下表)。
  4. 客户端填 Base URL + Key,按对应章节配置模型名。
Key 勿泄露、勿上传公开仓库。分组选错是最常见的「模型不存在 / 无权限 / 502」原因。

分组与路由(必读)

你在客户端里通常用 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,按张/按秒扣费
为什么这和「接口类型」有关? Claude、Gemini 等渠道并不是 OpenAI 协议。若渠道误配成 OpenAI 类型,字段会被改丢、响应不完整,表现为报错多、检测分低。本站已按上表为各模型族匹配协议;你只需选对分组和路径即可。

Codex 配置

Codex 通常需要配置 config.tomlauth.json。配置完成后重启 Codex 生效。

配置文件位置

  • Windows:%USERPROFILE%\.codex\config.toml
  • Windows:%USERPROFILE%\.codex\auth.json
  • macOS / Linux:~/.codex/config.toml
  • macOS / Linux:~/.codex/auth.json
config.toml 示例
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
auth.json 示例
{
  "OPENAI_API_KEY": "sk-替换为你的-小圆API-Key"
}

Key 分组选 gpt-codexgpt-codex-pro。若要用其他模型,把 modelreview_model 改成控制台中可用的模型名称即可。

切换模型

在 Codex 客户端内直接切换模型即可;config.tomlauth.json 与 Base URL 无需改动。可用模型名称以控制台「模型定价」为准。

Claude Code

Key 分组选 Claude 相关(如 claude-max)。配置完成后重启 Claude Code 生效。

配置文件位置

  • Windows:%USERPROFILE%\.claude\settings.json
  • macOS / Linux:~/.claude/settings.json
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"
  }
}
Claude 走 Anthropic 协议链路。Cherry Studio 等 OpenAI 客户端也可调 Claude 模型,但须使用带 Claude 权限的分组,路径为 /v1/chat/completions

Gemini

客户端按 OpenAI 格式发对话,站内转 Google Gemini · Token 选 Gemini / Gemini-Pro · 与 生图组 不是同一 Key

Base URLhttps://api.aixiaoyuan.work/v1
鉴权Authorization: Bearer sk-xxx
标准档分组Gemini
Pro 档分组Gemini-Pro
可用模型
gemini-3.5-flash gemini-3-flash-preview gemini-3.1-pro gemini-3.1-pro-preview gemini-3-pro-preview

标准档 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 示例
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
  }'
Cherry Studio 等 OpenAI 客户端:Base URL 填 https://api.aixiaoyuan.work/v1,模型填上表名称。Function Calling 报错时,可先关闭工具调用试纯对话。

SVIP 专线

与普通分组共用 /v1 入口;Token 选 svip专线,模型名须带 -svip 后缀(以控制台为准)

Base URLhttps://api.aixiaoyuan.work/v1
鉴权Authorization: Bearer sk-xxx
Token 分组svip专线
模型名控制台复制,须含 -svip
示例模型
gpt-5.4-mini-svip gpt-5.5-svip gemini-3.5-flash-svip claude-sonnet-4-6-svip
调用 POST /v1/chat/completions 分组 svip专线 模型填 xxx-svip
curl 示例
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 选 生图组 · 异步提交后轮询拿图/成片

Base URLhttps://api.aixiaoyuan.work/api/v1/studio
鉴权Authorization: Bearer sk-xxx
Token 分组生图组
扣费按产品单价扣控制台余额
调用流程 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 必填;其余参数见下表(与 /catalogcontrolskey 一致);参考图 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_promptseedprompt_extendwatermark

NanoBanana 系列清晰度参数名为 size(Classic 版为 imageSize),比例参数名为 aspectRatio

视频模型规格

与上表相同 API:POST /submit + GET /pollproduct_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(音频)。

常见问题

模型不存在 / 502 / 响应不完整?

先查 分组与路由:Codex 别用 Claude / Gemini 分组;生图只用 生图组 + /api/v1/studio,不要走 /v1/chat/completions/v1/images/generations

Gemini 报模型不存在?

确认分组为 GeminiGemini-Pro,模型用上方列表中的名称(如 gemini-3.5-flash)。

生图 API 报 401 / 余额不足?

Token 分组必须是 生图组,Key 完整且未禁用,账户有余额。/poll 必须带 Authorization

API 地址填什么?

对话 / Codex / Claude / Gemini:https://api.aixiaoyuan.work/v1。生图:https://api.aixiaoyuan.work/api/v1/studio(与 /v1 不同路径,勿混填)。客户端会自动补 /v1 时,主站填 https://api.aixiaoyuan.work 即可。