https://openapi.pillxwell.vip 文档版本 2026-11-20 · 示例均可直接复制运行(替换 YOUR_API_KEY 与素材 URL)

概览与认证

PillXwell OpenAPI · 视频生成 / 图像生成与编辑

平台提供 OpenAI 兼容风格的生成接口:视频走异步任务(提交 → 轮询 → 下载),图像同步出图。左侧点击任一模型可查看全量参数表与完整 curl 样例。

免费试用:联系商务 Telegram(CTF CTF)获取模型免费使用配额。查看联系方式

基础信息

参数类型必填默认值说明
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 标准 ProPOST /v1/videos异步任务
w3.0-video-prime视频 · W3.0 PrimePOST /v1/videos异步任务
w3.0-video-prime-pro视频 · W3.0 Prime ProPOST /v1/videos异步任务
wan2.7-i2v-spicy视频 · 图生视频 / 音频驱动POST /v1/videos异步任务
wan2.2-i2v-spicy视频 · 图生视频POST /v1/videos异步任务
w2.2-i2v-lora视频 · 图生视频 + LoRAPOST /v1/videos异步任务
z-image-spicy图像 · 文生图POST /v1/images/generations同步
z-image-spicy-pro图像 · 文生图 ProPOST /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 -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

完整流程、状态枚举与轮询脚本见「视频调用流程」。

快速开始 · 图像(一步)

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
GET  /v1/videos/{task_id}/content   → 下载视频(或直接下载结果 url)
GET  /v1/tasks/{task_id}            → (可选)完整任务详情,失败时取 fail_reason

提交响应字段

参数类型必填默认值说明
idstring——任务 ID(task_ 前缀);部分版本同时返回 task_id,两者一致
objectstring——固定 video
modelstring——本次提交的模型名
statusstring——受理成功为 queued
progressinteger——进度百分比 0–100
created_atinteger——创建时间(Unix 秒)

状态枚举

status(/v1/videos)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

轮询脚本示例(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

查询失败原因

/v1/videos/{id} 只给状态,不给失败原因。失败时用 GET /v1/tasks/{task_id} 取 fail_reason(该接口状态为大写枚举,成功时 data 内含上游原始结果):

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A(推荐):直接下载查询响应中的 url 直链,无需鉴权头。方式 B:经平台代理:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

注意事项

  • 生成耗时从几十秒到数分钟不等(随时长、分辨率、排队波动),建议 5–10 秒轮询一次。
  • 每次提交生成 1 个视频;需要多个请分次提交。
  • 任务按令牌隔离:只能用提交它的同一把令牌查询,否则报任务不存在。
  • 结果 URL 为临时直链,请及时下载转存,平台不保证长期保留。
  • 提交成功即已受理并预扣费;不要重复提交同一内容(每次 POST 都是新任务、新计费)。

图像调用说明同步返回

适用于全部 5 个图像模型

入口划分

入口模型用途
POST /v1/images/generationsz-image-spicy / z-image-spicy-pro文生图
POST /v1/images/editsqwen-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 标准慢速版,支持文生视频、首尾帧、参考图/视频/音频、文档与网页素材。

POST /v1/videos 分辨率:480p / 720p / 1080p(默认 1080p) 时长:2–30 秒(默认 5) 目录价 $0.036–0.143/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 w3.0-video
promptstring条件—文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一
first_framestring可选—首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用
last_framestring可选—尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式
reference_imagesstring[]可选—参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式
reference_videosstring[]可选—参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式
reference_audiosstring[]可选—参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式
filestring可选—文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式
linkstring可选—公开网页 URL(免认证可访问);与 file 互斥。参考模式
resolutionstring可选1080p档位:480p / 720p / 1080p(大小写不敏感)
ratiostring可选adaptive宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
sizestring可选—可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先
secondsinteger可选5输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s
audioboolean可选true是否输出音轨;开关不影响计费
prompt_extendboolean可选true是否由上游扩写 prompt;false 贴近字面 prompt
seedinteger可选随机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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

w3.0-video-pro视频生成异步任务

W3.0 标准 Pro · Stand 标准慢速版

W3.0 标准 Pro,高分辨率档位(1080p / 2k / 4k),请求契约与标准版一致。

POST /v1/videos 分辨率:1080p / 2k / 4k(默认 1080p) 时长:2–30 秒(默认 5) 目录价 $0.129–0.164/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 w3.0-video-pro
promptstring条件—文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一
first_framestring可选—首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用
last_framestring可选—尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式
reference_imagesstring[]可选—参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式
reference_videosstring[]可选—参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式
reference_audiosstring[]可选—参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式
filestring可选—文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式
linkstring可选—公开网页 URL(免认证可访问);与 file 互斥。参考模式
resolutionstring可选1080p档位:1080p / 2k / 4k(大小写不敏感)
ratiostring可选adaptive宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
sizestring可选—可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先
secondsinteger可选5输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s
audioboolean可选true是否输出音轨;开关不影响计费
prompt_extendboolean可选true是否由上游扩写 prompt;false 贴近字面 prompt
seedinteger可选随机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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

w3.0-video-prime视频生成异步任务

W3.0 Prime · Prime 快速版

W3.0 Prime 快速版,生成速度更快,请求契约与标准版一致。

POST /v1/videos 分辨率:480p / 720p / 1080p(默认 1080p) 时长:2–30 秒(默认 5) 目录价 $0.058–0.240/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 w3.0-video-prime
promptstring条件—文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一
first_framestring可选—首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用
last_framestring可选—尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式
reference_imagesstring[]可选—参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式
reference_videosstring[]可选—参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式
reference_audiosstring[]可选—参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式
filestring可选—文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式
linkstring可选—公开网页 URL(免认证可访问);与 file 互斥。参考模式
resolutionstring可选1080p档位:480p / 720p / 1080p(大小写不敏感)
ratiostring可选adaptive宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
sizestring可选—可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先
secondsinteger可选5输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s
audioboolean可选true是否输出音轨;开关不影响计费
prompt_extendboolean可选true是否由上游扩写 prompt;false 贴近字面 prompt
seedinteger可选随机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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

w3.0-video-prime-pro视频生成异步任务

W3.0 Prime Pro · Prime 快速版

W3.0 Prime Pro(VSR-Prime),快速版 + 高分辨率档位,请求契约与标准版一致。

POST /v1/videos 分辨率:1080p / 2k / 4k(默认 1080p) 时长:2–30 秒(默认 5) 目录价 $0.223–0.266/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 w3.0-video-prime-pro
promptstring条件—文本提示词,最长 20000 字符(超长上游截断不拒绝);与媒体输入至少提供其一
first_framestring可选—首帧图,仅 1 张;URL / data:image Data URI / 纯 Base64。关键帧模式,不可与参考模式混用
last_framestring可选—尾帧图,仅 1 张;输入形式同 first_frame。关键帧模式
reference_imagesstring[]可选—参考图,最多 10 张,三种输入形式可混用;prompt 中用 “Image 1”、“Image 2” 索引引用。参考模式
reference_videosstring[]可选—参考视频,最多 5 个、总时长 ≤15s;仅 URL(mp4 / mov)。参考模式
reference_audiosstring[]可选—参考音频,最多 5 个、总时长 ≤15s;仅 URL(wav / mp3)。参考模式
filestring可选—文档素材 URL:docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md;≤100MB;PDF/DOC/PPT 限 50 页;与 link 互斥。参考模式
linkstring可选—公开网页 URL(免认证可访问);与 file 互斥。参考模式
resolutionstring可选1080p档位:1080p / 2k / 4k(大小写不敏感)
ratiostring可选adaptive宽高比:adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
sizestring可选—可选便捷写法:像素串如 1280x720(x 或 * 均可)或 auto;按短边折算 resolution、按宽高比折算 ratio;显式传的 resolution / ratio 优先
secondsinteger可选5输出时长,2–30 的整数;duration 为等价别名(优先读 seconds);不支持 -1(智能时长);带参考视频输入时输入+输出合计 ≤30s
audioboolean可选true是否输出音轨;开关不影响计费
prompt_extendboolean可选true是否由上游扩写 prompt;false 贴近字面 prompt
seedinteger可选随机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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

wan2.7-i2v-spicy视频生成异步任务

Wan 2.7 spicy I2V · 图生视频 · 支持音频驱动

以一张图片为起点生成视频,可传驱动音频(audio_url)让人物口型/动作跟随音频。

POST /v1/videos 分辨率:720p / 1080p(默认 1080p) 时长:2–15 秒(默认 5) 目录价 $0.186–0.286/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 wan2.7-i2v-spicy
promptstring必填—文本提示词
imagestring必填—参考图片;URL / data:image Data URI / 纯 Base64(也接受字段名 first_frame / input_reference)
secondsinteger可选5时长 2–15 秒整数;duration 为等价别名;不支持 -1
resolutionstring可选1080p720p / 1080p
audioboolean可选true是否输出音轨
prompt_extendboolean可选true智能提示词扩写;false 贴近字面 prompt
negative_promptstring可选—反向提示词(不希望出现的内容)
audio_urlstring可选—驱动音频 URL(WAV / MP3,2–30 秒);不传即普通图生视频
seedinteger可选随机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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

wan2.2-i2v-spicy视频生成异步任务

Wan 2.2 spicy I2V · 图生视频

以一张图片为起点生成视频,可选尾帧图控制结束画面。

POST /v1/videos 分辨率:480p / 720p(默认 480p) 时长:5 或 8 秒(默认 5) 目录价 $0.029–0.057/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 wan2.2-i2v-spicy
promptstring必填—文本提示词
imagestring必填—输入图片;URL / data:image Data URI / 纯 Base64(也接受字段名 first_frame / input_reference)
secondsinteger可选5时长只能 5 或 8;duration 为等价别名;不支持 -1
resolutionstring可选480p480p / 720p
last_imagestring可选—尾帧图(也接受字段名 last_frame);URL / Data URI / Base64
prompt_extendboolean可选true智能提示词扩写
seedinteger可选随机随机种子

调用示例(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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

w2.2-i2v-lora视频生成异步任务

Wan 2.2 I2V-LoRA spicy · 图生视频 + LoRA 风格/动作控制

在图生视频基础上加载 LoRA 权重,控制风格或动作;支持通用 / 高噪声 / 低噪声三组权重。

POST /v1/videos 分辨率:480p / 720p(默认 480p) 时长:5 或 8 秒(默认 5) LoRA:每组 ≤3 个,scale 0–4 目录价 $0.029–0.057/秒

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 w2.2-i2v-lora
promptstring必填—文本提示词
imagestring必填—输入图片;URL / data:image Data URI / 纯 Base64(也接受字段名 first_frame / input_reference)
secondsinteger可选5时长只能 5 或 8;duration 为等价别名;不支持 -1
resolutionstring可选480p480p / 720p
lorasarray可选—通用 LoRA 权重列表,最多 3 项;元素结构见下
high_noise_lorasarray可选—高噪声阶段 LoRA,最多 3 项;元素结构同 loras
low_noise_lorasarray可选—低噪声阶段 LoRA,最多 3 项;元素结构同 loras
seedinteger可选随机随机种子

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)含义对应 /v1/tasks 状态
queued已创建 / 排队中QUEUED
in_progress生成中IN_PROGRESS
completed成功,响应带 urlSUCCESS
failed失败,原因见下方查询FAILURE

查询失败原因

/v1/videos/{id} 只给状态;失败原因用 GET /v1/tasks/{task_id} 的 fail_reason 字段获取:

curl -X GET "https://openapi.pillxwell.vip/v1/tasks/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f",
    "status": "FAILURE",
    "progress": "100%",
    "fail_reason": "task failed (code 3005): Green net check failed for image (output): Output data may contain inappropriate content.",
    "created_at": 1795132800,
    "finish_time": 1795132860,
    "data": {}
  }
}

下载视频

方式 A:直接下载查询响应中的 url(无需鉴权头)。方式 B:经平台代理下载:

curl -X GET "https://openapi.pillxwell.vip/v1/videos/task_8f2c1d9e4a7b4c0f9d3e5a1b2c3d4e5f/content" \
  -H "Authorization: Bearer YOUR_API_KEY"

结果 URL 为临时直链,请及时下载转存;任务未完成或无产物时 content 接口报错。

z-image-spicy图像同步返回

Z-Image spicy · 文生图

文本生成图片,默认竖版 1024×1536,支持智能提示词扩写。

POST /v1/images/generations 尺寸:256–1536 px 默认:1024 × 1536 prompt_extend 默认 true

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 z-image-spicy
promptstring必填—文本提示词
ninteger可选1出图数量,只能为 1
sizestring可选1024x1536像素串 宽x高(x 或 * 均可);与 width/height 二选一
widthinteger可选1024图片宽度,256–1536;与 size 二选一
heightinteger可选1536图片高度,256–1536;与 size 二选一
prompt_extendboolean可选true智能提示词扩写;false 贴近字面 prompt
seedinteger可选随机随机种子

调用示例(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),默认关闭提示词扩写。

POST /v1/images/generations 尺寸:256–2560 px 默认:1024 × 1024 prompt_extend 默认 false

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 z-image-spicy-pro
promptstring必填—文本提示词
ninteger可选1出图数量,只能为 1
sizestring可选1024x1024像素串 宽x高(x 或 * 均可);与 width/height 二选一
widthinteger可选1024图片宽度,256–2560;与 size 二选一
heightinteger可选1024图片高度,256–2560;与 size 二选一
prompt_extendboolean可选false是否扩写 prompt;默认关闭
seedinteger可选随机随机种子(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 张)。

POST /v1/images/edits 主图:1 张(必填) 参考图:≤2 张 编辑指令 prompt 必填

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 qwen-image-edit-spicy
imagestring必填—待编辑的图片(主图);URL / data:image Data URI / 纯 Base64
promptstring必填—编辑指令,如“把背景换成海滩”
reference_imagesstring[]可选—参考图,最多 2 张;主图 + 参考图合计 ≤3 张
seedinteger可选随机随机种子

调用示例(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。

POST /v1/images/edits 目标图 image 必填 源人脸 face_image 必填

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 face-swap
imagestring必填—目标图(被换脸的照片);URL / data:image Data URI / 纯 Base64
face_imagestring必填—源人脸图(要换上去的脸);URL / Data URI / Base64
seedinteger可选随机随机种子

调用示例(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。

POST /v1/images/edits 目标图 image 必填 参考头部 head_image 必填

请求参数(全量)

参数类型必填默认值说明
modelstring必填—固定 head-swap
imagestring必填—目标图(被换头的照片);URL / data:image Data URI / 纯 Base64
head_imagestring必填—参考头部图(提供头部的照片);URL / Data URI / Base64
seedinteger可选随机随机种子(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_videosmp4 / mov≤100MB边长 240–4096px,宽高比 ≤8:1;单个 1–15s 且总计 ≤15s
reference_audioswav / mp3≤15MB单个 1–15s 且总计 ≤15s
file(文档素材)docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md≤100MBPDF/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常见 code / 文案含义与处理
401Invalid token令牌缺失 / 无效 / 已禁用,检查 Authorization 头
403insufficient_user_quota余额不足(视频提交按预估费用预扣),充值后重试
400参数校验错误(如 seconds must be between 2 and 30、image is required)按对应模型参数表修正请求
400model_price_error该模型未在当前分组配置价格,联系平台管理员
404fail_to_fetch_task / Not Found模型服务不可用或未开通,联系平台管理员
429限流并发 / QPS 超限,退避重试(见下表)
503no available channel模型服务暂不可用(未开通或维护),联系平台管理员

任务层失败(提交成功但生成失败)

视频受理成功后,失败发生在异步阶段:GET /v1/videos/{id} 显示 status:"failed",原因在 GET /v1/tasks/{id} 的 data.fail_reason(形如 task failed (code 3005): ...)。

上游服务错误码速查

以下码出现在提交响应或 fail_reason 中:

码类别含义处理
429限流并发 / QPS 超限,提交时即返回。参考并发:W3.0 标准版 10、Prime 快速版 2退避重试、控制提交速率;更高并发联系平台
451内容安全输入侧内容拦截(未成年人、政治/商业人物、宗教、国旗国徽等)红线内容不会放宽;确属误判可反馈平台
3002内容安全请求阶段内容安全拦截提示信息可展示给最终用户;不计费
3005执行失败混合错误,看 detail:含 “Green net check failed” = 输出被内容安全拦截;含 “InternalError.Algo” = 上游短时波动;其余多为输入不合规(大小/时长超限)波动类建议重试;输入类修正素材;输出拦截类调整 prompt
4002基础设施“Timeout during proxy download”:上游下载你提供的素材 URL 超时换稳定、可公网直连的素材 URL
400 / InvalidParameter / VALIDATION_ERROR参数校验输入不合法(动图、分辨率、格式、尺寸差 1px 等)对照「输入素材限制」修正
2001兼容性multipart 上传格式兼容问题改用 JSON + URL 方式提交
Invalid API-key鉴权上游密钥无效联系平台管理员

常见问题

  • 生成内容被异常替换 / 不贴 prompt:prompt 扩写异常,设 "prompt_extend": false 重试。
  • 输出疑似真人人脸被拦(FaceDetectionSuspect,常包装为 3005):大头照易触发,全身/中景一般可过;调整 prompt 避免真人指向或直接重试(生成有随机性)。
  • 疑似 IP 侵权(IPInfringementSuspect):AI 生成图作输入也可能触发,更换素材。
  • 错误信息被截断:上游已知问题(长 URL 触发),可凭 task_id 请平台查原始错误。
  • 生成失败扣费吗:输入侧拦截(451 / 3002)不产生生成、不计费;其余按平台计费策略。
  • 轮询很久没结果:高峰期任务时长波动大,保持耐心轮询;提交成功即已受理,不要重复提交。

计费与配额

新用户可联系商务获取模型免费使用配额,见 联系商务 · 免费配额。

计费规则

  • 视频:按 输出时长(秒)× 分辨率目录价 计费;提交时按预估费用预扣,失败按平台策略结算。audio:false 不减价。
  • 图像:按张计费(每次请求 1 张),单价以平台配置为准。
  • 输入侧内容拦截(451 / 3002)不产生生成、不计费。

视频模型目录价(美金 / 秒)

视频模型分辨率单价(美金)
w3.0-video480p$0.036
w3.0-video720p$0.072
w3.0-video1080p$0.143
w3.0-video-pro1080p$0.129
w3.0-video-pro2K$0.143
w3.0-video-pro4K$0.164
w3.0-video-prime480p$0.058
w3.0-video-prime720p$0.120
w3.0-video-prime1080p$0.240
w3.0-video-prime-pro1080p$0.223
w3.0-video-prime-pro2K$0.240
w3.0-video-prime-pro4K$0.266
w2.2-i2v-lora480p$0.029
w2.2-i2v-lora720p$0.057
wan2.2-i2v-spicy480p$0.029
wan2.2-i2v-spicy720p$0.057
wan2.7-i2v-spicy720p$0.186
wan2.7-i2v-spicy1080p$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

联系方式

  • 使用 Telegram 扫描左侧二维码,添加商务 CTF CTF。
  • 或直接点击链接:t.me/+16398169627
  • 添加时请备注平台账号与用途,便于快速开通。
打开 Telegram 联系商务

免费配额额度与开通规则以商务沟通为准。