代码API 调用文档

Base URL: https://api.wow3.top
鉴权:请求头带令牌 Authorization: Bearer sk-xxxxxxxx(在「令牌」页面创建)
模型路由:请求体的 model 字段决定走哪个渠道。网关按 模型名 + 令牌分组 + 渠道优先级 自动路由到具体上游,调用方无需关心底层是 OpenAI / Claude / Gemini。

方式一:统一用 OpenAI 兼容格式(推荐)

三种渠道的模型都能用同一个端点调用,只改 model 名。

端点:POST /v1/chat/completions

Bash

curl https://api.wow3.top/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "你好"}
    ],
    "stream": false
  }'

只需替换 model 即可切换渠道:

渠道	示例 model
OpenAI	gpt-5.4、gpt-5.5、gpt-5.4-mini
Claude	`claude-opus-4-8`、`claude-sonnet-4-6`、claude-opus-4-7、claude-sonnet-5、claude-fable-5
Gemini	`gemini-2.5-pro`、`gemini-3.5-flash`

流式:"stream": true,响应为 SSE(data: {...}\n\n,以 data: [DONE] 结束)。

Python(openai SDK):

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://api.wow3.top/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",   # 换成任意渠道的模型名
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

方式二:Claude 原生格式(Messages API)

需要用 Anthropic 原生字段(顶层 system、thinking、原生工具格式)时使用。

端点:POST /v1/messages

Bash

curl https://api.wow3.top/v1/messages \
  -H "x-api-key: sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "你是一个有用的助手",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Claude 原生鉴权用 x-api-key 头(不是 Authorization: Bearer),并需要 anthropic-version 头;max_tokens 必填。

Python(anthropic SDK):

Python

import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxxxxxxx",
    base_url="https://api.wow3.top",
)

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

方式三:Gemini 原生格式

需要用 Google 原生字段(generationConfig、safetySettings)时使用。

端点:POST /v1beta/models/{model}:generateContent(流式为 :streamGenerateContent)

Bash

curl "https://api.wow3.top/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "你好"}]}
    ]
  }'

Gemini 也兼容官方的 x-goog-api-key: sk-xxxxxxxx 头或 ?key=sk-xxxxxxxx 查询参数。

画图API使用方法

打开你的cc或者codex，把群公告文档扔给它，再把你的key，baseurl，model给它就行

gpt-image-2 返回的是base64
gpt-image-2-4k返回的是url，有效期是1个月

quality 参数取值

gpt-image-2 实测支持 4 个档位，只能用这几个值：

quality	结果
auto	✅ 200（默认，模型自选）
high	✅ 200
medium	✅ 200
low	✅ 200

说明：可用值为 auto / high / medium / low，是 OpenAI gpt-image 系列标准档位；不支持 DALL·E 时代的 standard / hd。耗时与档位无严格正相关（受上游排队影响，波动大）。

图片生成接口

1k的参数示例

SQL

curl -X POST '
https://api.wow3.top/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <你的key>' \
--data-raw '{
    "size": "1024x1024",
    "prompt": "画小猫",
    "model": "gpt-image-2"
}'

2k的参数示例

SQL

curl -X POST '
https://api.wow3.top/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <你的key>' \
--data-raw '{
    "size": "2048x2048",
    "prompt": "画小猫",
    "model": "gpt-image-2-4k"
}'

4k的参数示例

SQL

curl -X POST '
https://api.wow3.top/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <你的key>' \
--data-raw '{
    "size": "3840x2160",
    "prompt": "画小猫",
    "model": "gpt-image-2-4k"
}'

图片编辑接口

SQL

curl --request POST \
  --url 'https://api.wow3.top/v1/images/edits' \
  --header 'Authorization: Bearer sk-******' \
  --header 'content-type: multipart/form-data' \
  --form 'image=@文件路径' \
  --form 'prompt=粘土风格 所有人都占起来' \
  --form model=gpt-image-2-4k \
  --form n=1 \
  --form quality=auto \
  --form size=1024x1024

要点：

image=@文件路径，@ 前缀表示上传本地文件。
不要手写 --header 'content-type: multipart/form-data'，curl 会自动带上正确的 boundary。
--max-time 300：接口较慢，超时给足。
size尺寸：1024x1024、2048x2048、4096x4096、1920x1080、3584x2016、3168x1344

size	比例
1024x1024	1:01
2048x2048	1:1 (2K)
4096x4096	1:1 (4K)
1920x1080	16:09
3584x2016	16:09
3168x1344	21:09

python代码示意

Python

import base64
import requests

resp = requests.post(
    "https://api.wow3.top/v1/images/edits",
    headers={"Authorization": "Bearer sk-你的key"},
    files={"image": open("test_people.png", "rb")},   # 关键：以文件流上传
    data={
        "prompt": "粘土风格 所有人都站起来",
        "model": "gpt-image-2",
        "n": 1,
        "quality": "auto",
        "size": "1024x1024",
    },
    timeout=300,
)
resp.raise_for_status()
item = resp.json()["data"][0]

if item.get("b64_json"):
    with open("result.png", "wb") as f:
        f.write(base64.b64decode(item["b64_json"]))
    print("已保存 result.png")
elif item.get("url"):
    print("结果 URL:", item["url"])

响应格式（成功 HTTP 200）

顶层结构：

字段	类型	说明
created	int	生成时间戳（秒）
data	array	结果数组，长度 = n
data[].b64_json	string	base64 图片（gpt-image-2 返回此字段）
data[].url	string	图片直链（gpt-image-2-4k 返回此字段，OSS 链接）
usage	object	计费用量，见下

⚠️ 两模型返回字段不同：gpt-image-2 给 b64_json，gpt-image-2-4k 给 url。客户端必须两种都判断（先看 url，再看 b64_json）。

`gpt-image-2-4k` 真实响应（url 形式）

JSON

{
  "data": [
    { "url": "https://yoozi-us1.oss-us-west-1.aliyuncs.com/proxyapi/images/img-xxxx.png" }
  ],
  "created": 1784476014,
  "usage": {
    "total_tokens": 1024,
    "input_tokens": 259,
    "output_tokens": 765,
    "input_tokens_details": {
      "text_tokens": 4,
      "image_tokens": 255
    }
  }
}

`gpt-image-2` 响应（base64 形式）

JSON

{
  "created": 1784474159,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...(很长的 base64)" }
  ]
}

常见错误

HTTP	含义	排查
401	令牌无效/过期	检查 `Authorization` 头和令牌状态;确认令牌确实创建于本实例
404	模型无可用渠道	该 model 未绑定到启用的渠道,或不在令牌分组内
429	限流/额度不足	令牌额度、渠道限流、分组倍率
503	渠道全部熔断	上游异常,查渠道状态/熔断记录

SKILLs方式调用画图

附件待补充

此处原为飞书附件，导出时未包含。请上传至 R2 后在此替换为下载直链。

设置api-key环境变量

Bash

优先读 WOW3_IMAGE，其次 API_KEY。设置方式（任选其一）：

临时 shell（当前会话生效）
export WOW3_IMAGE="sk-你的key"

写进 ~/.bashrc / ~/.zshrc（永久）
echo 'export WOW3_IMAGE="sk-你的key"' >> ~/.bashrc
source ~/.bashrc

单次调用时前置
WOW3_IMAGE=sk-xxx python3 scripts/wow3_image.py generate --prompt "..." --size 1024x1024

Claude Code 全局配置（推荐，Claude Code 会话内自动带上）
在 ~/.claude/settings.json 里加：
{
  "env": {
    "WOW3_IMAGE": "sk-你的key"
  }
}

key 从 https://api.wow3.top/ 控制台「② API Key」创建。

代码API 调用文档 ​

方式一:统一用 OpenAI 兼容格式(推荐) ​

方式二:Claude 原生格式(Messages API) ​

方式三:Gemini 原生格式 ​

画图API使用方法 ​

quality 参数取值 ​

图片生成接口 ​

图片编辑接口 ​

响应格式（成功 HTTP 200） ​

gpt-image-2-4k 真实响应（url 形式） ​

gpt-image-2 响应（base64 形式） ​

常见错误 ​

SKILLs方式调用画图 ​

代码API 调用文档

方式一:统一用 OpenAI 兼容格式(推荐)

方式二:Claude 原生格式(Messages API)

方式三:Gemini 原生格式

画图API使用方法

quality 参数取值

图片生成接口

图片编辑接口

响应格式（成功 HTTP 200）

`gpt-image-2-4k` 真实响应（url 形式）

`gpt-image-2` 响应（base64 形式）

常见错误

SKILLs方式调用画图