概览与认证
PillXwell OpenAPI · 视频生成 / 图像生成与编辑
平台提供 OpenAI 兼容风格的生成接口:视频走异步任务(提交 → 轮询 → 下载),图像同步出图。左侧点击任一模型可查看全量参数表与完整 curl 样例。
基础信息
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Base URL | — | — | — | https://openapi.pillxwell.vip |
认证 | — | — | — | 请求头 Authorization: Bearer YOUR_API_KEY(平台 API 令牌,控制台创建) |
Content-Type | — | — | — | application/json |
模型总览
| 模型(点击查看) | 类型 | 调用入口 | 返回方式 |
|---|---|---|---|
w3.0-video | 视频 · W3.0 标准版 | POST /v1/videos | 异步任务 |
w3.0-video-pro | 视频 · W3.0 标准 Pro | POST /v1/videos | 异步任务 |
w3.0-video-prime | 视频 · W3.0 Prime | POST /v1/videos | 异步任务 |
w3.0-video-prime-pro | 视频 · W3.0 Prime Pro | POST /v1/videos | 异步任务 |
wan2.7-i2v-spicy | 视频 · 图生视频 / 音频驱动 | POST /v1/videos | 异步任务 |
wan2.2-i2v-spicy | 视频 · 图生视频 | POST /v1/videos | 异步任务 |
w2.2-i2v-lora | 视频 · 图生视频 + LoRA | POST /v1/videos | 异步任务 |
z-image-spicy | 图像 · 文生图 | POST /v1/images/generations | 同步 |
z-image-spicy-pro | 图像 · 文生图 Pro | POST /v1/images/generations | 同步 |
qwen-image-edit-spicy | 图像 · 图片编辑 | POST /v1/images/edits | 同步 |
face-swap | 图像 · 人脸替换 | POST /v1/images/edits | 同步 |
head-swap | 图像 · 头部替换 | POST /v1/images/edits | 同步 |
入口不可混用:视频模型只能走 /v1/videos;图像模型只能走 /v1/images/generations(文生图)或 /v1/images/edits(编辑/换脸/换头)。令牌所属分组决定可用模型与价格。
核对可用模型
curl -X GET "https://openapi.pillxwell.vip/v1/models" \
-H "Authorization: Bearer YOUR_API_KEY"返回 OpenAI 格式模型列表(data[].id 即模型名):
{
"object": "list",
"data": [
{
"id": "w3.0-video",
"object": "model"
},
{
"id": "z-image-spicy",
"object": "model"
}
]
}请求体格式约定
- 推荐 JSON;素材(图片等)用公网可直连访问的 URL传入,也接受
data:image/...;base64,Data URI 或纯 Base64 字符串。 - 视频入口
/v1/videos另支持multipart/form-data文件上传(字段名与 JSON 一致,如first_frame、image)。 - 未列出的字段会被忽略;本文 curl 为 bash 风格,Windows CMD/PowerShell 请自行调整引号与换行。
- 所有示例中的
YOUR_API_KEY与example.com素材地址需替换为你自己的令牌与素材。
快速开始 · 视频(三步)
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "镜头缓缓推进,城市灯光闪烁",
"resolution": "480p",
"seconds": 5,
"audio": false
}'curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"curl -O "https://cdn.example.com/output/xxxx.mp4"完整流程、状态枚举与轮询脚本见「视频调用流程」。
快速开始 · 图像(一步)
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy",
"prompt": "一只戴着宇航员头盔的猫,漂浮在空间站里,写实风格",
"size": "1024x1536"
}'同步返回 data[].url,详见「图像调用说明」。
视频调用流程异步任务
适用于全部 7 个视频模型
流程
POST /v1/videos → 200 返回 id(status=queued,受理即预扣费)
GET /v1/videos/{task_id} → 轮询 status:queued → in_progress → completed / failed提交响应字段
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
id | string | — | — | 任务 ID(task_ 前缀);部分版本同时返回 task_id,两者一致 |
object | string | — | — | 固定 video |
model | string | — | — | 本次提交的模型名 |
status | string | — | — | 受理成功为 queued |
progress | integer | — | — | 进度百分比 0–100 |
created_at | integer | — | — | 创建时间(Unix 秒) |
状态枚举
| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
轮询脚本示例(bash)
TASK_ID="task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f"
while true; do
RESP=$(curl -s -X GET "https://openapi.pillxwell.vip/v1/videos/$TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY")
STATUS=$(echo "$RESP" | grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
echo "status=$STATUS"
if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
echo "$RESP"
break
fi
sleep 8
done注意事项
- 生成耗时从几十秒到数分钟不等(随时长、分辨率、排队波动),建议 5–10 秒轮询一次。
- 每次提交生成 1 个视频;需要多个请分次提交。
- 任务按令牌隔离:只能用提交它的同一把令牌查询,否则报任务不存在。
- 结果 URL 为临时直链,请及时下载转存,平台不保证长期保留。
- 提交成功即已受理并预扣费;不要重复提交同一内容(每次 POST 都是新任务、新计费)。
图像调用说明同步返回
适用于全部 5 个图像模型
入口划分
| 入口 | 模型 | 用途 |
|---|---|---|
POST /v1/images/generations | z-image-spicy / z-image-spicy-pro | 文生图 |
POST /v1/images/edits | qwen-image-edit-spicy / face-swap / head-swap | 图片编辑 / 换脸 / 换头 |
调用方式
- 一次 POST 阻塞等待出图,成功直接返回图片 URL;无 task_id、无需轮询。
- 生成通常需数秒到数十秒,客户端超时建议设置 ≥300 秒。
- 每次请求固定出 1 张图(
n只能为 1);多张请分次请求。 - 请求体为 JSON,图片字段传 URL / Data URI / Base64,无需 multipart 上传。
响应
{
"created": 1795132800,
"data": [
{
"url": "https://cdn.example.com/output/yyyy.png"
}
]
}created:创建时间(Unix 秒);data[].url:结果图直链,请及时下载转存。- 失败时返回 HTTP 4xx/5xx + 结构化错误(见「错误码与排查」),不出图。
w3.0-video视频生成异步任务
W3.0 标准版 · Stand 标准慢速版
W3.0 标准慢速版,支持文生视频、首尾帧、参考图/视频/音频、文档与网页素材。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 w3.0-video |
prompt | string | 条件 | — | 文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一 |
first_frame | string | 可选 | — | 首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用 |
last_frame | string | 可选 | — | 尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式 |
reference_images | string[] | 可选 | — | 参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式 |
reference_videos | string[] | 可选 | — | 参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式 |
reference_audios | string[] | 可选 | — | 参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式 |
file | string | 可选 | — | 文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式 |
link | string | 可选 | — | 公开网页 URL(免认证可访问);与 file 互斥。参考模式 |
resolution | string | 可选 | 1080p | 档位:480p / 720p / 1080p(大小写不敏感) |
ratio | string | 可选 | adaptive | 宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 |
size | string | 可选 | — | 可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先 |
seconds | integer | 可选 | 5 | 输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s |
audio | boolean | 可选 | true | 是否输出音轨;开关不影响计费 |
prompt_extend | boolean | 可选 | true | 是否由上游扩写 prompt;false 贴近字面 prompt |
seed | integer | 可选 | 随机 | 0–2147483647 |
模式互斥:关键帧模式(first_frame / last_frame)与参考模式(reference_images / reference_videos / reference_audios / file / link)不可混用;file 与 link 不可同时传。因此下方按模式分示例,全部示例合计覆盖每一个参数。输入素材的格式/大小限制见「输入素材限制」。
调用示例(curl)
① 完整参数 · 文生视频
覆盖全部生成控制参数(resolution / ratio / seconds / audio / prompt_extend / seed)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "无人机视角掠过清晨的海面,金色阳光洒在波浪上",
"resolution": "720p",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'② 完整参数 · 首尾帧(关键帧模式)
first_frame / last_frame 与参考模式互斥;其余生成参数同上。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "画面从白天平滑过渡到夜晚,光影自然变化",
"first_frame": "https://example.com/day.jpg",
"last_frame": "https://example.com/night.jpg",
"resolution": "720p",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'③ 完整参数 · 参考图 + 参考视频 + 参考音频(参考模式)
prompt 用 Image N 引用参考图;参考视频输入 + 输出合计 ≤30s。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "Image 1 中的角色在 Image 2 的场景里奔跑,动作节奏跟随参考视频,氛围配合参考音频",
"reference_images": [
"https://example.com/character.jpg",
"https://example.com/scene.jpg"
],
"reference_videos": [
"https://example.com/motion.mp4"
],
"reference_audios": [
"https://example.com/bgm.mp3"
],
"resolution": "480p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'④ 完整参数 · 文档素材 file
file 与 link 二选一;素材 URL 建议带正确扩展名(如 .pptx)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "把这份产品介绍做成宣传短片,突出核心卖点",
"file": "https://example.com/product-intro.pptx",
"resolution": "720p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑤ 完整参数 · 网页素材 link
link 需免认证可公网访问;与 file 互斥。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "根据这个网页的内容生成一条介绍短片",
"link": "https://example.com/product-page",
"resolution": "720p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑥ 可选写法 · 用 size 指定尺寸
size 按短边折算分辨率档位、按宽高比折算 ratio;与 resolution / ratio 同传时后者优先。auto 表示自动。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video",
"prompt": "城市夜景延时摄影,车流光轨",
"size": "1280x720",
"seconds": 5,
"audio": false
}'提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
w3.0-video-pro视频生成异步任务
W3.0 标准 Pro · Stand 标准慢速版
W3.0 标准 Pro,高分辨率档位(1080p / 2k / 4k),请求契约与标准版一致。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 w3.0-video-pro |
prompt | string | 条件 | — | 文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一 |
first_frame | string | 可选 | — | 首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用 |
last_frame | string | 可选 | — | 尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式 |
reference_images | string[] | 可选 | — | 参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式 |
reference_videos | string[] | 可选 | — | 参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式 |
reference_audios | string[] | 可选 | — | 参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式 |
file | string | 可选 | — | 文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式 |
link | string | 可选 | — | 公开网页 URL(免认证可访问);与 file 互斥。参考模式 |
resolution | string | 可选 | 1080p | 档位:1080p / 2k / 4k(大小写不敏感) |
ratio | string | 可选 | adaptive | 宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 |
size | string | 可选 | — | 可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先 |
seconds | integer | 可选 | 5 | 输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s |
audio | boolean | 可选 | true | 是否输出音轨;开关不影响计费 |
prompt_extend | boolean | 可选 | true | 是否由上游扩写 prompt;false 贴近字面 prompt |
seed | integer | 可选 | 随机 | 0–2147483647 |
模式互斥:关键帧模式(first_frame / last_frame)与参考模式(reference_images / reference_videos / reference_audios / file / link)不可混用;file 与 link 不可同时传。因此下方按模式分示例,全部示例合计覆盖每一个参数。输入素材的格式/大小限制见「输入素材限制」。
调用示例(curl)
① 完整参数 · 文生视频
覆盖全部生成控制参数(resolution / ratio / seconds / audio / prompt_extend / seed)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-pro",
"prompt": "无人机视角掠过清晨的海面,金色阳光洒在波浪上",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'② 完整参数 · 首尾帧(关键帧模式)
first_frame / last_frame 与参考模式互斥;其余生成参数同上。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-pro",
"prompt": "画面从白天平滑过渡到夜晚,光影自然变化",
"first_frame": "https://example.com/day.jpg",
"last_frame": "https://example.com/night.jpg",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'③ 完整参数 · 参考图 + 参考视频 + 参考音频(参考模式)
prompt 用 Image N 引用参考图;参考视频输入 + 输出合计 ≤30s。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-pro",
"prompt": "Image 1 中的角色在 Image 2 的场景里奔跑,动作节奏跟随参考视频,氛围配合参考音频",
"reference_images": [
"https://example.com/character.jpg",
"https://example.com/scene.jpg"
],
"reference_videos": [
"https://example.com/motion.mp4"
],
"reference_audios": [
"https://example.com/bgm.mp3"
],
"resolution": "2k",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'④ 完整参数 · 文档素材 file
file 与 link 二选一;素材 URL 建议带正确扩展名(如 .pptx)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-pro",
"prompt": "把这份产品介绍做成宣传短片,突出核心卖点",
"file": "https://example.com/product-intro.pptx",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑤ 完整参数 · 网页素材 link
link 需免认证可公网访问;与 file 互斥。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-pro",
"prompt": "根据这个网页的内容生成一条介绍短片",
"link": "https://example.com/product-page",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑥ 可选写法 · 用 size 指定尺寸
size 按短边折算分辨率档位、按宽高比折算 ratio;与 resolution / ratio 同传时后者优先。auto 表示自动。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-pro",
"prompt": "城市夜景延时摄影,车流光轨",
"size": "1920x1080",
"seconds": 5,
"audio": false
}'提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video-pro",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video-pro",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
w3.0-video-prime视频生成异步任务
W3.0 Prime · Prime 快速版
W3.0 Prime 快速版,生成速度更快,请求契约与标准版一致。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 w3.0-video-prime |
prompt | string | 条件 | — | 文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一 |
first_frame | string | 可选 | — | 首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用 |
last_frame | string | 可选 | — | 尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式 |
reference_images | string[] | 可选 | — | 参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式 |
reference_videos | string[] | 可选 | — | 参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式 |
reference_audios | string[] | 可选 | — | 参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式 |
file | string | 可选 | — | 文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式 |
link | string | 可选 | — | 公开网页 URL(免认证可访问);与 file 互斥。参考模式 |
resolution | string | 可选 | 1080p | 档位:480p / 720p / 1080p(大小写不敏感) |
ratio | string | 可选 | adaptive | 宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 |
size | string | 可选 | — | 可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先 |
seconds | integer | 可选 | 5 | 输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s |
audio | boolean | 可选 | true | 是否输出音轨;开关不影响计费 |
prompt_extend | boolean | 可选 | true | 是否由上游扩写 prompt;false 贴近字面 prompt |
seed | integer | 可选 | 随机 | 0–2147483647 |
模式互斥:关键帧模式(first_frame / last_frame)与参考模式(reference_images / reference_videos / reference_audios / file / link)不可混用;file 与 link 不可同时传。因此下方按模式分示例,全部示例合计覆盖每一个参数。输入素材的格式/大小限制见「输入素材限制」。
调用示例(curl)
① 完整参数 · 文生视频
覆盖全部生成控制参数(resolution / ratio / seconds / audio / prompt_extend / seed)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime",
"prompt": "无人机视角掠过清晨的海面,金色阳光洒在波浪上",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'② 完整参数 · 首尾帧(关键帧模式)
first_frame / last_frame 与参考模式互斥;其余生成参数同上。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime",
"prompt": "画面从白天平滑过渡到夜晚,光影自然变化",
"first_frame": "https://example.com/day.jpg",
"last_frame": "https://example.com/night.jpg",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'③ 完整参数 · 参考图 + 参考视频 + 参考音频(参考模式)
prompt 用 Image N 引用参考图;参考视频输入 + 输出合计 ≤30s。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime",
"prompt": "Image 1 中的角色在 Image 2 的场景里奔跑,动作节奏跟随参考视频,氛围配合参考音频",
"reference_images": [
"https://example.com/character.jpg",
"https://example.com/scene.jpg"
],
"reference_videos": [
"https://example.com/motion.mp4"
],
"reference_audios": [
"https://example.com/bgm.mp3"
],
"resolution": "720p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'④ 完整参数 · 文档素材 file
file 与 link 二选一;素材 URL 建议带正确扩展名(如 .pptx)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime",
"prompt": "把这份产品介绍做成宣传短片,突出核心卖点",
"file": "https://example.com/product-intro.pptx",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑤ 完整参数 · 网页素材 link
link 需免认证可公网访问;与 file 互斥。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime",
"prompt": "根据这个网页的内容生成一条介绍短片",
"link": "https://example.com/product-page",
"resolution": "1080p",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑥ 可选写法 · 用 size 指定尺寸
size 按短边折算分辨率档位、按宽高比折算 ratio;与 resolution / ratio 同传时后者优先。auto 表示自动。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime",
"prompt": "城市夜景延时摄影,车流光轨",
"size": "1280x720",
"seconds": 5,
"audio": false
}'提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video-prime",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video-prime",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
w3.0-video-prime-pro视频生成异步任务
W3.0 Prime Pro · Prime 快速版
W3.0 Prime Pro(VSR-Prime),快速版 + 高分辨率档位,请求契约与标准版一致。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 w3.0-video-prime-pro |
prompt | string | 条件 | — | 文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一 |
first_frame | string | 可选 | — | 首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用 |
last_frame | string | 可选 | — | 尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式 |
reference_images | string[] | 可选 | — | 参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式 |
reference_videos | string[] | 可选 | — | 参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式 |
reference_audios | string[] | 可选 | — | 参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式 |
file | string | 可选 | — | 文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式 |
link | string | 可选 | — | 公开网页 URL(免认证可访问);与 file 互斥。参考模式 |
resolution | string | 可选 | 1080p | 档位:1080p / 2k / 4k(大小写不敏感) |
ratio | string | 可选 | adaptive | 宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 |
size | string | 可选 | — | 可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先 |
seconds | integer | 可选 | 5 | 输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s |
audio | boolean | 可选 | true | 是否输出音轨;开关不影响计费 |
prompt_extend | boolean | 可选 | true | 是否由上游扩写 prompt;false 贴近字面 prompt |
seed | integer | 可选 | 随机 | 0–2147483647 |
模式互斥:关键帧模式(first_frame / last_frame)与参考模式(reference_images / reference_videos / reference_audios / file / link)不可混用;file 与 link 不可同时传。因此下方按模式分示例,全部示例合计覆盖每一个参数。输入素材的格式/大小限制见「输入素材限制」。
调用示例(curl)
① 完整参数 · 文生视频
覆盖全部生成控制参数(resolution / ratio / seconds / audio / prompt_extend / seed)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime-pro",
"prompt": "无人机视角掠过清晨的海面,金色阳光洒在波浪上",
"resolution": "2k",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'② 完整参数 · 首尾帧(关键帧模式)
first_frame / last_frame 与参考模式互斥;其余生成参数同上。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime-pro",
"prompt": "画面从白天平滑过渡到夜晚,光影自然变化",
"first_frame": "https://example.com/day.jpg",
"last_frame": "https://example.com/night.jpg",
"resolution": "2k",
"ratio": "16:9",
"seconds": 5,
"audio": true,
"prompt_extend": true,
"seed": 42
}'③ 完整参数 · 参考图 + 参考视频 + 参考音频(参考模式)
prompt 用 Image N 引用参考图;参考视频输入 + 输出合计 ≤30s。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime-pro",
"prompt": "Image 1 中的角色在 Image 2 的场景里奔跑,动作节奏跟随参考视频,氛围配合参考音频",
"reference_images": [
"https://example.com/character.jpg",
"https://example.com/scene.jpg"
],
"reference_videos": [
"https://example.com/motion.mp4"
],
"reference_audios": [
"https://example.com/bgm.mp3"
],
"resolution": "4k",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'④ 完整参数 · 文档素材 file
file 与 link 二选一;素材 URL 建议带正确扩展名(如 .pptx)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime-pro",
"prompt": "把这份产品介绍做成宣传短片,突出核心卖点",
"file": "https://example.com/product-intro.pptx",
"resolution": "2k",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑤ 完整参数 · 网页素材 link
link 需免认证可公网访问;与 file 互斥。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime-pro",
"prompt": "根据这个网页的内容生成一条介绍短片",
"link": "https://example.com/product-page",
"resolution": "2k",
"ratio": "16:9",
"seconds": 10,
"audio": true,
"prompt_extend": true,
"seed": 42
}'⑥ 可选写法 · 用 size 指定尺寸
size 按短边折算分辨率档位、按宽高比折算 ratio;与 resolution / ratio 同传时后者优先。auto 表示自动。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w3.0-video-prime-pro",
"prompt": "城市夜景延时摄影,车流光轨",
"size": "1920x1080",
"seconds": 5,
"audio": false
}'提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video-prime-pro",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w3.0-video-prime-pro",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
wan2.7-i2v-spicy视频生成异步任务
Wan 2.7 spicy I2V · 图生视频 · 支持音频驱动
以一张图片为起点生成视频,可传驱动音频(audio_url)让人物口型/动作跟随音频。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 wan2.7-i2v-spicy |
prompt | string | 必填 | — | 文本提示词 |
image | string | 必填 | — | 参考图片;URL / data:image Data URI / 纯 Base64(也接受字段名 first_frame / input_reference) |
seconds | integer | 可选 | 5 | 时长 2–15 秒整数;duration 为等价别名;不支持 -1 |
resolution | string | 可选 | 1080p | 720p / 1080p |
audio | boolean | 可选 | true | 是否输出音轨 |
prompt_extend | boolean | 可选 | true | 智能提示词扩写;false 贴近字面 prompt |
negative_prompt | string | 可选 | — | 反向提示词(不希望出现的内容) |
audio_url | string | 可选 | — | 驱动音频 URL(WAV / MP3,2–30 秒);不传即普通图生视频 |
seed | integer | 可选 | 随机 | 0–2147483647 |
调用示例(curl)
① 完整参数(含音频驱动)
覆盖全部参数:image + prompt + audio_url + resolution + seconds + audio + prompt_extend + negative_prompt + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-i2v-spicy",
"prompt": "人物随着音乐节奏唱歌,表情自然,镜头轻微推近",
"image": "https://example.com/portrait.jpg",
"audio_url": "https://example.com/voice.mp3",
"resolution": "720p",
"seconds": 8,
"audio": true,
"prompt_extend": true,
"negative_prompt": "模糊,变形,低画质",
"seed": 42
}'② 最小参数(普通图生视频)
仅必填项,其余走默认值(1080p / 5 秒 / 有声 / 扩写开启)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-i2v-spicy",
"prompt": "画面中的人物缓缓转头微笑",
"image": "https://example.com/portrait.jpg"
}'提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "wan2.7-i2v-spicy",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "wan2.7-i2v-spicy",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
wan2.2-i2v-spicy视频生成异步任务
Wan 2.2 spicy I2V · 图生视频
以一张图片为起点生成视频,可选尾帧图控制结束画面。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 wan2.2-i2v-spicy |
prompt | string | 必填 | — | 文本提示词 |
image | string | 必填 | — | 输入图片;URL / data:image Data URI / 纯 Base64(也接受字段名 first_frame / input_reference) |
seconds | integer | 可选 | 5 | 时长只能 5 或 8;duration 为等价别名;不支持 -1 |
resolution | string | 可选 | 480p | 480p / 720p |
last_image | string | 可选 | — | 尾帧图(也接受字段名 last_frame);URL / Data URI / Base64 |
prompt_extend | boolean | 可选 | true | 智能提示词扩写 |
seed | integer | 可选 | 随机 | 随机种子 |
调用示例(curl)
① 完整参数(含尾帧)
覆盖全部参数:image + prompt + last_image + resolution + seconds + prompt_extend + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.2-i2v-spicy",
"prompt": "镜头围绕人物缓慢旋转,衣摆随风摆动,结尾定格在侧面",
"image": "https://example.com/input.jpg",
"last_image": "https://example.com/ending.jpg",
"resolution": "720p",
"seconds": 8,
"prompt_extend": true,
"seed": 42
}'② 最小参数
仅必填项,其余走默认值(480p / 5 秒 / 扩写开启)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.2-i2v-spicy",
"prompt": "人物向镜头挥手致意",
"image": "https://example.com/input.jpg"
}'提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "wan2.2-i2v-spicy",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "wan2.2-i2v-spicy",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
w2.2-i2v-lora视频生成异步任务
Wan 2.2 I2V-LoRA spicy · 图生视频 + LoRA 风格/动作控制
在图生视频基础上加载 LoRA 权重,控制风格或动作;支持通用 / 高噪声 / 低噪声三组权重。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 w2.2-i2v-lora |
prompt | string | 必填 | — | 文本提示词 |
image | string | 必填 | — | 输入图片;URL / data:image Data URI / 纯 Base64(也接受字段名 first_frame / input_reference) |
seconds | integer | 可选 | 5 | 时长只能 5 或 8;duration 为等价别名;不支持 -1 |
resolution | string | 可选 | 480p | 480p / 720p |
loras | array | 可选 | — | 通用 LoRA 权重列表,最多 3 项;元素结构见下 |
high_noise_loras | array | 可选 | — | 高噪声阶段 LoRA,最多 3 项;元素结构同 loras |
low_noise_loras | array | 可选 | — | 低噪声阶段 LoRA,最多 3 项;元素结构同 loras |
seed | integer | 可选 | 随机 | 随机种子 |
LoRA 元素结构(三个数组通用):
{
"url": "https://example.com/lora-weights.safetensors",
"scale": 0.8
}url:LoRA 权重文件的公网 HTTP(S) 直链(权重文件最大 1GB,上游不另收权重费)。scale:权重强度,0–4 的数字。
调用示例(curl)
① 完整参数(三组 LoRA 全带)
覆盖全部参数:image + prompt + loras + high_noise_loras + low_noise_loras + resolution + seconds + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w2.2-i2v-lora",
"prompt": "人物跳起指定的舞蹈动作,动作流畅自然",
"image": "https://example.com/dancer.jpg",
"loras": [
{
"url": "https://example.com/dance-style.safetensors",
"scale": 0.8
}
],
"high_noise_loras": [
{
"url": "https://example.com/motion-hi.safetensors",
"scale": 0.6
}
],
"low_noise_loras": [
{
"url": "https://example.com/detail-lo.safetensors",
"scale": 0.7
}
],
"resolution": "720p",
"seconds": 5,
"seed": 42
}'② 常用写法(单 LoRA)
只传一组 loras,其余走默认值(480p / 5 秒)。
curl -X POST "https://openapi.pillxwell.vip/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "w2.2-i2v-lora",
"prompt": "人物跳起指定的舞蹈动作",
"image": "https://example.com/dancer.jpg",
"loras": [
{
"url": "https://example.com/dance-style.safetensors",
"scale": 0.8
}
]
}'目录价:480p $0.029/秒、720p $0.057/秒;LoRA 权重免费(≤1GB)。
提交响应
HTTP 200,受理成功立即返回(不等生成完成)。id 即任务 ID(部分版本同时返回 task_id,两者一致)。
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w2.2-i2v-lora",
"status": "queued",
"progress": 0,
"created_at": 1795132800
}查询任务
GET /v1/videos/{task_id} 用提交时的同一把令牌轮询,建议 5–10 秒一次。
curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
-H "Authorization: Bearer YOUR_API_KEY"完成时响应(url 即视频直链):
{
"id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
"object": "video",
"model": "w2.2-i2v-lora",
"status": "completed",
"progress": 100,
"created_at": 1795132800,
"completed_at": 1795132895,
"url": "https://cdn.example.com/output/xxxx.mp4"
}| status(/v1/videos) | 含义 |
|---|---|
queued | 已创建 / 排队中 |
in_progress | 生成中 |
completed | 成功,响应带 url |
failed | 失败 |
z-image-spicy图像同步返回
Z-Image spicy · 文生图
文本生成图片,默认竖版 1024×1536,支持智能提示词扩写。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 z-image-spicy |
prompt | string | 必填 | — | 文本提示词 |
n | integer | 可选 | 1 | 出图数量,只能为 1 |
size | string | 可选 | 1024x1536 | 像素串 宽x高(x 或 * 均可);与 width/height 二选一 |
width | integer | 可选 | 1024 | 图片宽度,256–1536;与 size 二选一 |
height | integer | 可选 | 1536 | 图片高度,256–1536;与 size 二选一 |
prompt_extend | boolean | 可选 | true | 智能提示词扩写;false 贴近字面 prompt |
seed | integer | 可选 | 随机 | 随机种子 |
调用示例(curl)
① 完整参数(size 写法)
覆盖全部参数:prompt + n + size + prompt_extend + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy",
"prompt": "赛博朋克风格的雨夜街道,霓虹灯倒映在积水中",
"n": 1,
"size": "1024x1536",
"prompt_extend": true,
"seed": 42
}'② 完整参数(width / height 写法)
与 size 等价;此处演示关闭扩写。
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy",
"prompt": "一只戴着宇航员头盔的猫,漂浮在空间站里,写实风格",
"n": 1,
"width": 1024,
"height": 1536,
"prompt_extend": false,
"seed": 42
}'③ 最小参数
仅必填项,默认 1024×1536、扩写开启。
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy",
"prompt": "极简主义产品摄影,白色背景上的香水瓶"
}'响应示例
HTTP 200,同步返回图片直链(无 task_id、无需轮询):
{
"created": 1795132800,
"data": [
{
"url": "https://cdn.example.com/output/yyyy.png"
}
]
}注意事项
- 请求阻塞到出图,通常数秒到数十秒,客户端超时建议 ≥300 秒。
- 每次请求固定出 1 张图(
n只能为 1);多张请分次请求。 data[].url为临时直链,请及时下载转存。- 失败时返回 HTTP 4xx/5xx 结构化错误(见「错误码与排查」),不出图。
z-image-spicy-pro图像同步返回
Z-Image spicy Pro · 文生图
文生图 Pro 版,支持更大尺寸(最高 2560×2560),默认关闭提示词扩写。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 z-image-spicy-pro |
prompt | string | 必填 | — | 文本提示词 |
n | integer | 可选 | 1 | 出图数量,只能为 1 |
size | string | 可选 | 1024x1024 | 像素串 宽x高(x 或 * 均可);与 width/height 二选一 |
width | integer | 可选 | 1024 | 图片宽度,256–2560;与 size 二选一 |
height | integer | 可选 | 1024 | 图片高度,256–2560;与 size 二选一 |
prompt_extend | boolean | 可选 | false | 是否扩写 prompt;默认关闭 |
seed | integer | 可选 | 随机 | 随机种子(0 或 null 表示随机) |
调用示例(curl)
① 完整参数(width / height 写法)
覆盖全部参数:prompt + n + width + height + prompt_extend + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy-pro",
"prompt": "极简主义产品摄影,白色背景上的香水瓶,柔和阴影",
"n": 1,
"width": 2048,
"height": 2048,
"prompt_extend": false,
"seed": 42
}'② 完整参数(size 写法)
与 width/height 等价;此处演示开启扩写。
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy-pro",
"prompt": "电影感海报,雨中的霓虹城市",
"n": 1,
"size": "1536x1536",
"prompt_extend": true,
"seed": 7
}'③ 最小参数
仅必填项,默认 1024×1024、扩写关闭。
curl -X POST "https://openapi.pillxwell.vip/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image-spicy-pro",
"prompt": "水彩风格的山水插画"
}'响应示例
HTTP 200,同步返回图片直链(无 task_id、无需轮询):
{
"created": 1795132800,
"data": [
{
"url": "https://cdn.example.com/output/yyyy.png"
}
]
}注意事项
- 请求阻塞到出图,通常数秒到数十秒,客户端超时建议 ≥300 秒。
- 每次请求固定出 1 张图(
n只能为 1);多张请分次请求。 data[].url为临时直链,请及时下载转存。- 失败时返回 HTTP 4xx/5xx 结构化错误(见「错误码与排查」),不出图。
qwen-image-edit-spicy图像同步返回
Qwen Image Edit spicy · 图片编辑
按指令编辑图片,可附参考图(主图 + 参考图合计 ≤3 张)。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 qwen-image-edit-spicy |
image | string | 必填 | — | 待编辑的图片(主图);URL / data:image Data URI / 纯 Base64 |
prompt | string | 必填 | — | 编辑指令,如“把背景换成海滩” |
reference_images | string[] | 可选 | — | 参考图,最多 2 张;主图 + 参考图合计 ≤3 张 |
seed | integer | 可选 | 随机 | 随机种子 |
调用示例(curl)
① 完整参数(含参考图)
覆盖全部参数:image + prompt + reference_images + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/images/edits" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-edit-spicy",
"image": "https://example.com/photo.jpg",
"prompt": "给人物戴上参考图中的红色墨镜,保持其他部分不变",
"reference_images": [
"https://example.com/glasses-ref.jpg",
"https://example.com/style-ref.jpg"
],
"seed": 42
}'② 最小参数
仅主图 + 编辑指令。
curl -X POST "https://openapi.pillxwell.vip/v1/images/edits" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-edit-spicy",
"image": "https://example.com/photo.jpg",
"prompt": "把背景换成海滩"
}'响应示例
HTTP 200,同步返回图片直链(无 task_id、无需轮询):
{
"created": 1795132800,
"data": [
{
"url": "https://cdn.example.com/output/yyyy.png"
}
]
}注意事项
- 请求阻塞到出图,通常数秒到数十秒,客户端超时建议 ≥300 秒。
- 每次请求固定出 1 张图(
n只能为 1);多张请分次请求。 data[].url为临时直链,请及时下载转存。- 失败时返回 HTTP 4xx/5xx 结构化错误(见「错误码与排查」),不出图。
face-swap图像同步返回
Face Swap · 人脸替换
把源人脸换到目标照片上。无需 prompt。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 face-swap |
image | string | 必填 | — | 目标图(被换脸的照片);URL / data:image Data URI / 纯 Base64 |
face_image | string | 必填 | — | 源人脸图(要换上去的脸);URL / Data URI / Base64 |
seed | integer | 可选 | 随机 | 随机种子 |
调用示例(curl)
① 完整参数(含 seed)
覆盖全部参数:image + face_image + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/images/edits" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "face-swap",
"image": "https://example.com/target-photo.jpg",
"face_image": "https://example.com/source-face.jpg",
"seed": 42
}'② 最小参数
仅两张必填图。
curl -X POST "https://openapi.pillxwell.vip/v1/images/edits" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "face-swap",
"image": "https://example.com/target-photo.jpg",
"face_image": "https://example.com/source-face.jpg"
}'响应示例
HTTP 200,同步返回图片直链(无 task_id、无需轮询):
{
"created": 1795132800,
"data": [
{
"url": "https://cdn.example.com/output/yyyy.png"
}
]
}注意事项
- 请求阻塞到出图,通常数秒到数十秒,客户端超时建议 ≥300 秒。
- 每次请求固定出 1 张图(
n只能为 1);多张请分次请求。 data[].url为临时直链,请及时下载转存。- 失败时返回 HTTP 4xx/5xx 结构化错误(见「错误码与排查」),不出图。
head-swap图像同步返回
Head Swap · 头部替换
把参考头部换到目标照片上。无需 prompt。
请求参数(全量)
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 必填 | — | 固定 head-swap |
image | string | 必填 | — | 目标图(被换头的照片);URL / data:image Data URI / 纯 Base64 |
head_image | string | 必填 | — | 参考头部图(提供头部的照片);URL / Data URI / Base64 |
seed | integer | 可选 | 随机 | 随机种子(0 或 null 表示随机) |
调用示例(curl)
① 完整参数(含 seed)
覆盖全部参数:image + head_image + seed。
curl -X POST "https://openapi.pillxwell.vip/v1/images/edits" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "head-swap",
"image": "https://example.com/target-photo.jpg",
"head_image": "https://example.com/source-head.jpg",
"seed": 42
}'② 最小参数
仅两张必填图。
curl -X POST "https://openapi.pillxwell.vip/v1/images/edits" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "head-swap",
"image": "https://example.com/target-photo.jpg",
"head_image": "https://example.com/source-head.jpg"
}'响应示例
HTTP 200,同步返回图片直链(无 task_id、无需轮询):
{
"created": 1795132800,
"data": [
{
"url": "https://cdn.example.com/output/yyyy.png"
}
]
}注意事项
- 请求阻塞到出图,通常数秒到数十秒,客户端超时建议 ≥300 秒。
- 每次请求固定出 1 张图(
n只能为 1);多张请分次请求。 data[].url为临时直链,请及时下载转存。- 失败时返回 HTTP 4xx/5xx 结构化错误(见「错误码与排查」),不出图。
输入素材限制
适用于视频模型的媒体输入(W3.0 系列与 wan 系列参考输入)
媒体硬约束
| 输入 | 格式 | 大小 | 其他约束 |
|---|---|---|---|
| 图片(first_frame / last_frame / reference_images / image) | JPEG / JPG / PNG(无 alpha 透明通道)/ BMP / WEBP | ≤20MB | 边长 240–8000px,宽高比 ≤8:1 |
| reference_videos | mp4 / mov | ≤100MB | 边长 240–4096px,宽高比 ≤8:1;单个 1–15s 且总计 ≤15s |
| reference_audios | wav / mp3 | ≤15MB | 单个 1–15s 且总计 ≤15s |
| file(文档素材) | docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md | ≤100MB | PDF/DOC/PPT 限 50 页 |
模式互斥(W3.0 系列)
- 关键帧模式(
first_frame/last_frame)与参考模式(reference_images/reference_videos/reference_audios/file/link)不可混用。 file与link不可同时传。prompt、关键帧、参考输入至少提供其一。
其他
- prompt 最长 20000 字符(超长上游截断,不拒绝)。
- 素材 URL 建议带正确文件扩展名(如
.pptx/.pdf),并使用稳定、可公网直连的地址——上游下载超时会被判失败(错误码 4002)。 - 参考图三种输入形式(URL / Data URI / Base64)可混用;参考视频/音频仅支持 URL。
- face-swap / head-swap / qwen-image-edit-spicy 的输入图以 URL / Base64 传入即可。
错误码与排查
错误响应格式
{
"error": {
"message": "Invalid token (request id: 202611191552527927681438268d9d6)",
"code": ""
}
}接口层错误(HTTP 响应直接返回)
| HTTP / 错误码 | 类别 | 含义与处理 |
|---|---|---|
| 401 | 鉴权 | Invalid token:令牌缺失 / 无效 / 已禁用,检查 Authorization 头 |
| Invalid API-key | 鉴权 | 上游密钥无效,联系平台管理员 |
| 403 | 配额 | insufficient_user_quota:余额不足(视频提交按预估费用预扣),充值后重试 |
| 400 | 参数校验 | 参数校验错误(如 seconds must be between 2 and 30、image is required、InvalidParameter / VALIDATION_ERROR:动图、分辨率、格式、尺寸差 1px 等),按对应模型参数表与「输入素材限制」修正请求 |
| 400 | 价格 | model_price_error:该模型未在当前分组配置价格,联系平台管理员 |
| 404 | 服务 | fail_to_fetch_task / Not Found:模型服务不可用或未开通,联系平台管理员 |
| 429 | 限流 | 并发 / QPS 超限,提交时即返回(参考并发:W3.0 标准版 10、Prime 快速版 2);退避重试、控制提交速率,更高并发联系平台 |
| 503 | 服务 | no available channel:模型服务暂不可用(未开通或维护),联系平台管理员 |
| 451 | 内容安全 | 输入侧内容拦截(未成年人、政治/商业人物、宗教、国旗国徽等);红线内容不会放宽,确属误判可反馈平台 |
| 3002 | 内容安全 | 请求阶段内容安全拦截;提示信息可展示给最终用户,不计费 |
| 3005 | 执行失败 | 混合错误,看 detail:含 “Green net check failed” = 输出被内容安全拦截;含 “InternalError.Algo” = 上游短时波动;其余多为输入不合规(大小/时长超限)。波动类建议重试;输入类修正素材;输出拦截类调整 prompt |
| 4002 | 基础设施 | “Timeout during proxy download”:上游下载你提供的素材 URL 超时;换稳定、可公网直连的素材 URL |
| 2001 | 兼容性 | multipart 上传格式兼容问题;改用 JSON + URL 方式提交 |
任务层失败(提交成功但生成失败)
视频受理成功后,失败发生在异步阶段:轮询 GET /v1/videos/{id} 会返回 status:"failed";请结合下方常见问题排查后重试。
常见问题
- 生成内容被异常替换 / 不贴 prompt:prompt 扩写异常,设
"prompt_extend": false重试。 - 输出疑似真人人脸被拦(FaceDetectionSuspect,常包装为 3005):大头照易触发,全身/中景一般可过;调整 prompt 避免真人指向或直接重试(生成有随机性)。
- 疑似 IP 侵权(IPInfringementSuspect):AI 生成图作输入也可能触发,更换素材。
- 错误信息被截断:上游已知问题(长 URL 触发),可凭 task_id 请平台查原始错误。
- 生成失败扣费吗:输入侧拦截(451 / 3002)不产生生成、不计费;其余按平台计费策略。
- 轮询很久没结果:高峰期任务时长波动大,保持耐心轮询;提交成功即已受理,不要重复提交。
计费与配额
计费规则
- 视频:按 输出时长(秒)× 分辨率目录价 计费;提交时按预估费用预扣,失败按平台策略结算。
audio:false不减价。 - 图像:按张计费(每次请求 1 张),单价以平台配置为准。
- 输入侧内容拦截(451 / 3002)不产生生成、不计费。
视频模型目录价(美金 / 秒)
| 视频模型 | 分辨率 | 单价(美金) |
|---|---|---|
w3.0-video | 480p | $0.036 |
w3.0-video | 720p | $0.072 |
w3.0-video | 1080p | $0.143 |
w3.0-video-pro | 1080p | $0.129 |
w3.0-video-pro | 2K | $0.143 |
w3.0-video-pro | 4K | $0.164 |
w3.0-video-prime | 480p | $0.058 |
w3.0-video-prime | 720p | $0.120 |
w3.0-video-prime | 1080p | $0.240 |
w3.0-video-prime-pro | 1080p | $0.223 |
w3.0-video-prime-pro | 2K | $0.240 |
w3.0-video-prime-pro | 4K | $0.266 |
w2.2-i2v-lora | 480p | $0.029 |
w2.2-i2v-lora | 720p | $0.057 |
wan2.2-i2v-spicy | 480p | $0.029 |
wan2.2-i2v-spicy | 720p | $0.057 |
wan2.7-i2v-spicy | 720p | $0.186 |
wan2.7-i2v-spicy | 1080p | $0.286 |
并发与限流
- 参考并发:W3.0 标准版(w3.0-video / w3.0-video-pro)10;Prime 快速版(w3.0-video-prime / w3.0-video-prime-pro)2。
- 超并发返回 429(提交时即返回,不是排队阶段):退避重试、控制提交速率;需要更高并发联系商务。
- 余额与用量请在平台控制台查看。
联系商务 · 免费配额
Telegram:CTF CTF
联系商务获取模型免费使用配额;同时受理模型开通、并发提升与计费咨询。
联系方式
- 使用 Telegram 扫描左侧二维码,添加商务 CTF CTF。
- 或直接点击链接:t.me/+16398169627
- 添加时请备注平台账号与用途,便于快速开通。
免费配额额度与开通规则以商务沟通为准。