API 文档中心
一个 Key,调用对话、图片与视频模型
OpenAI 兼容接口。Claude 对话、GPT Image / Seedream / 可灵 图片,Seedance 与万相视频,统一走 https://api.wxbjai.com。
–可用模型
–视频模型
–图片模型
–对话模型
# 提交视频任务(异步)
curl https://api.wxbjai.com/v1/videos \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model":"seedance-2.5-720",
"prompt":"海边日落,镜头缓慢推进",
"seconds":"5"}'
# → {"id":"task_xxx","status":"queued"}
文档目录
必读
快速开始
接口地址、令牌与分组、三种调用方式。
对话
Claude 对话
OpenAI 格式与 Anthropic 原生格式都可用,支持流式。
图片
图片生成
GPT Image、Seedream、可灵、Qwen Image,同步返回图片地址。
视频
Seedance 视频
文生视频、参考图/视频/音频、视频编辑与延长,按秒或按次计费。
视频
万相 wan3.0 视频
阿里万相 3.0,480P / 720P / 1080P,按秒计费。
实时
模型列表与价格
当前上架的全部模型、所属分组和计费方式。
开始 / 快速开始
快速开始
所有接口都在同一个地址,用令牌鉴权。换模型只需要改 model 字段。
基础信息
| 项 | 值 |
|---|---|
| 接口地址 | https://api.wxbjai.com(OpenAI SDK 的 base_url 填 https://api.wxbjai.com/v1) |
| 鉴权 | 请求头 Authorization: Bearer sk-你的令牌;Anthropic 原生接口也可用 x-api-key |
| 令牌 | 登录 控制台 → 令牌 → 新建 |
| Content-Type | application/json |
令牌分组
每个令牌属于一个分组,分组决定能调用哪些模型以及价格倍率。新建令牌时选好分组:
| 分组 | 可用模型 |
|---|---|
default | 视频模型(Seedance、万相) |
claude「MAX」 | Claude 对话模型 |
图片专属 | 图片生成模型 |
分组与模型的对应以「模型列表」页为准,那里的数据是实时的。
三种调用方式
对话:同步 / 流式
POST /v1/chat/completions 或 POST /v1/messages,直接返回结果。图片:同步
POST /v1/images/generations,等生成完返回图片地址,通常 30 秒 ~ 2 分钟。视频:异步任务
POST /v1/videos 立刻返回任务 id,再用 GET /v1/videos/{id} 每 5~10 秒查一次,直到 completed。Python 示例(视频)
import time, requests
BASE = "https://api.wxbjai.com"
H = {"Authorization": "Bearer sk-你的令牌"}
task = requests.post(f"{BASE}/v1/videos", headers=H, json={
"model": "seedance-2.5-720",
"prompt": "海边日落,海浪拍打礁石,镜头缓慢推进",
"seconds": "5",
"aspect_ratio": "16:9",
}).json()
print(task) # {"id": "task_xxx", "status": "queued", ...}
while True:
r = requests.get(f"{BASE}/v1/videos/{task['id']}", headers=H).json()
print(r["status"], r.get("progress"))
if r["status"] in ("completed", "failed"):
break
time.sleep(8)
if r["status"] == "completed":
video = requests.get(r["video_url"], timeout=300).content # 链接 24 小时内有效
open("out.mp4", "wb").write(video)
开始 / 计费说明
计费说明
| 类型 | 怎么算 | 适用 |
|---|---|---|
| 按 token | 输入、输出、缓存分别按单价计费 | Claude 对话 |
| 按次 | 每张图 / 每条视频固定价格 | 图片模型、部分视频模型 |
| 按秒 | 视频实际时长 × 每秒单价 | seedance-2.5、521ai-SD、wan3.0 等 |
视频任务怎么扣费
提交时预扣按请求里的时长预扣(不传时长按 4 秒;视频编辑按最长 30 秒预扣)。
完成后结算按上游返回的实际时长多退少补。
失败退款任务失败会自动退回预扣的额度。
每个模型的实时价格见 模型列表,或控制台的「模型广场」。实际扣费 = 模型单价 × 分组倍率。
开始 / 错误码
错误码
| HTTP | 含义 | 处理 |
|---|---|---|
| 400 | 参数错误,如时长越界、缺少 prompt、素材超限 | 按返回的 message 修改 |
| 401 | 令牌无效 | 检查 Authorization 头 |
| 403 | 额度不足或令牌分组不能用这个模型 | 充值,或换对应分组的令牌 |
| 404 / model_not_found | 模型名写错,或当前分组没有这个模型 | 对照「模型列表」 |
| 429 | 请求过快或上游排队已满 | 降低并发,稍后重试 |
| 500 / 503 | 上游临时故障 | 稍后重试;任务类请求失败不扣费 |
| 504 | 同步接口超时(多见于高清图片) | 稍后重试或换模型 |
对话 / Claude
Claude 对话
同一批 Claude 模型,OpenAI 格式和 Anthropic 原生格式都能调。令牌请选 claude「MAX」 分组。
OpenAI 格式
curl https://api.wxbjai.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "你好"}],
"max_tokens": 1024,
"stream": true
}'
Anthropic 原生格式
curl https://api.wxbjai.com/v1/messages \
-H "x-api-key: sk-你的令牌" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'
在客户端里使用
| 客户端 | 填写 |
|---|---|
| Claude Code | ANTHROPIC_BASE_URL=https://api.wxbjai.com,ANTHROPIC_AUTH_TOKEN=sk-你的令牌 |
| Cherry Studio / ChatBox 等 | 类型选 OpenAI 或 Anthropic,地址 https://api.wxbjai.com,填令牌 |
可用模型见 模型列表(筛选「对话」)。
图片生成
图片生成
同步接口,生成完直接返回图片地址。令牌请选 图片专属 分组。
curl https://api.wxbjai.com/v1/images/generations \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-lite",
"prompt": "一只橘猫坐在窗台上,阳光,写实摄影",
"n": 1
}'
# → {"created": 1795058968, "data": [{"url": "https://.../xxx.jpg"}]}
参数
| 参数 | 说明 |
|---|---|
model | 见下表 |
prompt | 画面描述 |
n | 张数,默认 1,按张计费 |
size / aspect_ratio | 尺寸或比例,各模型支持范围不同 |
模型
| 模型 | 说明 |
|---|---|
seedream-5-lite / seedream-5-pro / seedream-5.5 | 字节 Seedream,出图稳定 |
kling-image-v3 / kling-image-o3 | 快手可灵 |
gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst | GPT Image,细节好,耗时较长 |
qwen-image | 通义千问图片,出图快 |
高峰期 GPT Image、kling-image-o3、qwen-image 可能超过同步等待时间而返回 504,稍后重试即可,超时的请求不扣费。返回的图片链接请及时下载保存。
视频生成 / Seedance
Seedance 视频
字节 Seedance 2.0 / 2.5。异步任务:提交 → 轮询 → 下载。令牌请选 default 分组。
接口
| 步骤 | 接口 |
|---|---|
| 提交 | POST /v1/videos |
| 查询 | GET /v1/videos/{id} |
| 下载(可选) | GET /v1/videos/{id}/content(带令牌,跳转到成片) |
提交任务
curl https://api.wxbjai.com/v1/videos \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-720",
"prompt": "夜晚城市天台上的一只橘猫,霓虹灯闪烁,电影质感",
"seconds": "8",
"aspect_ratio": "16:9"
}'
参数
| 参数 | 说明 |
|---|---|
model | 模型名,见下表 |
prompt | 必填,画面描述。不要只写「test」「你好」,这类请求不会生成视频 |
seconds / duration | 时长(秒)。2.5 系列 4~30 秒,超出直接报 400;2.0 系列 4~15 秒。默认 4 秒 |
aspect_ratio | 16:9 9:16 1:1 4:3 3:4 21:9 auto,默认 16:9 |
generate_audio | 是否生成音频,默认 true |
image_urls / video_urls / audio_urls | 参考素材(公网 URL)。提示词里用 @image1、@video1、@audio1 引用 |
mode | video_edit:改一段已有视频(时长跟随原视频);video_extend:接着原视频往下拍 |
带参考素材
{
"model": "seedance-2.5-720",
"prompt": "@image1 的人物按 @video1 的动作跳舞,配 @audio1 的音乐",
"seconds": 10,
"aspect_ratio": "9:16",
"image_urls": ["https://example.com/person.jpg"],
"video_urls": ["https://example.com/dance.mp4"],
"audio_urls": ["https://example.com/music.mp3"]
}
查询结果
curl https://api.wxbjai.com/v1/videos/task_xxx \
-H "Authorization: Bearer sk-你的令牌"
{
"id": "task_xxx",
"status": "completed", // queued → in_progress → completed / failed
"progress": 100,
"video_url": "https://....mp4", // 24 小时内有效,请及时下载
"seconds": 8,
"usage": {"seconds": 8}
}
模型
| 模型 | 规格 | 计费 |
|---|---|---|
seedance-2.5-720 / seedance-2.5-480 | Seedance 2.5,720p / 480p,4~30 秒,支持图/视频/音频参考 | 按秒 |
521ai-SD / 521ai-SD-480 / 521ai-SD-HD / 521ai-SD-4K | Seedance 2.0 企业版各分辨率 | 按秒 |
521ai-SD-fast-480-xd / 521ai-SD-fast-720-xd | Seedance 2.0 Fast | 按次 |
seedance2.5flash-480-XD / seedance2.5flash-720-XD / 521-2.5-SD-720XD | Seedance 2.5 特价档 | 按次 |
完整清单与实时价格见 模型列表。
视频生成 / 万相
万相 wan3.0 视频
阿里万相 3.0,按分辨率和秒数计费。令牌请选 default 分组。使用阿里云 DashScope 原生格式提交。
提交任务
curl https://api.wxbjai.com/ali/api/v1/services/aigc/video-generation/video-synthesis \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-H "X-DashScope-Async: enable" \
-d '{
"model": "wan3.0-video",
"input": {"prompt": "一只橘猫在窗台上伸懒腰,阳光,写实"},
"parameters": {"resolution": "720P", "duration": 5}
}'
# → {"output": {"task_id": "task_xxx", "task_status": "PENDING"}}
查询结果
用返回的 task_id 查询,两种写法都可以:
curl https://api.wxbjai.com/v1/videos/task_xxx \
-H "Authorization: Bearer sk-你的令牌"
curl https://api.wxbjai.com/ali/api/v1/tasks/task_xxx \
-H "Authorization: Bearer sk-你的令牌"
参数
| 参数 | 说明 |
|---|---|
input.prompt | 画面描述 |
input.media | 可选,参考图片/视频,如 [{"type":"first_frame","url":"https://..."}] |
parameters.resolution | 480P / 720P / 1080P,默认 1080P |
parameters.duration | 时长(秒),最长 30 |
参考 / 模型列表
模型列表与价格
数据实时读取自 api.wxbjai.com。价格为站内额度单价,实际扣费再乘以分组倍率。
加载中…