wylon
POSThttps://api.wylon.cn/v1/contents/generations/tasks
GEThttps://api.wylon.cn/v1/contents/generations/tasks/{task_id}
DELETEhttps://api.wylon.cn/v1/contents/generations/tasks/{task_id}

异步生成

创建文生视频任务,通过任务 ID 查询状态,并在生成成功后下载短时效 MP4 结果。

鉴权与请求格式

Authorizationstring · header必填
Bearer 令牌。可前往 控制台 创建 API 密钥,并将其保存为环境变量 $WYLON_API_KEY
Content-Typestring · header必填
创建任务时固定为 application/json

确认模型与当前限制

本文使用 lightx2v/LightWan2.2-A14B。可先调用列出模型确认当前 API 密钥能够访问该模型。

参数支持值默认值说明
duration55当前固定生成 5 秒视频
resolution480P720P480P输出尺寸由分辨率和画幅共同决定
ratio16:99:1616:9支持横向和纵向画幅
negative_prompt支持描述希望模型避开的画面元素或质量问题

运行时推理步数和帧率不是 V1 创建任务的公开请求字段。请勿传入 inference_stepsfps;实际帧率由成功响应的 framespersecond 返回。

创建视频任务

视频提示词通过 content 数组传递。当前只支持 type=text 的文本内容块。

创建任务
curl -sS --max-time 60 \
  -X POST "https://api.wylon.cn/v1/contents/generations/tasks" \
  -H "Authorization: Bearer ${WYLON_API_KEY}" \
  -H "Content-Type: application/json" \
  --data-binary '{
    "type": "video",
    "model": "lightx2v/LightWan2.2-A14B",
    "content": [{
      "type": "text",
      "text": "一只黑白长毛小猫在阳光下走来,真实电影摄影。"
    }],
    "duration": 5,
    "resolution": "480P",
    "ratio": "16:9"
  }' -o video-create-response.json

创建参数

typestring可选
指定任务生成的内容类型。文生视频请求传入 video;省略时服务端按视频任务处理,建议显式传入以提高请求可读性。
modelstring必填
wylon 提供的模型 ID,例如 lightx2v/LightWan2.2-A14B。可前往 模型广场 或通过 列出模型 确认可访问的模型。
contentarray必填
视频生成输入内容块。
typestring必填
指定输入内容块的类型。文生视频请求传入 text
textstring必填
用于描述期望生成内容的文本提示词,可包含主体、动作、场景、镜头、光线和风格等信息。
durationinteger可选
期望生成的视频时长,单位为秒。省略时使用所选模型的默认值;支持的取值及默认值请以对应模型的能力说明为准。
resolutionstring可选
期望输出的分辨率档位。省略时使用所选模型的默认值;支持的取值及对应输出尺寸由模型决定。
ratiostring可选
期望输出的视频画幅比例。省略时使用所选模型的默认值;支持的取值由模型决定。
negative_promptstring可选
描述不希望出现在生成结果中的内容。是否支持及具体效果由所选模型决定。
seedinteger可选
用于控制生成随机性的种子。是否支持、合法取值范围及结果可复现程度由所选模型决定。
safety_identifierstring可选
用于安全追踪的稳定终端用户标识。不要传入姓名、邮箱等直接身份信息。
execution_expires_afterinteger可选
任务执行过期阈值,单位为秒。超过阈值后任务可能停止执行。

查询任务

使用创建响应中的 id 查询任务。设置 detail=true 时,响应包含实际生效的 video_parameters

查询任务
VIDEO_TASK_ID=$(jq -r '.id' video-create-response.json)

curl -sS --get \
  "https://api.wylon.cn/v1/contents/generations/tasks/${VIDEO_TASK_ID}" \
  -H "Authorization: Bearer ${WYLON_API_KEY}" \
  --data-urlencode "detail=true" \
  -o video-task-response.json
状态含义建议操作
queued任务已受理,等待执行稍后继续查询
running视频正在生成稍后继续查询
succeeded任务成功获取并下载视频
failed任务执行失败读取 error
cancelled排队任务已取消停止轮询
expired任务或结果已过期需要时重新创建任务

读取并下载结果

status=succeededfile_status=available 时,视频地址位于 content.video_url

成功结果
{
  "id": "9065e7fd-2845-4e26-8850-1cf49a5d57c5",
  "status": "succeeded",
  "type": "video",
  "content": {
    "type": "video_url",
    "video_url": "https://example.com/generated/output.mp4?signature=REDACTED",
    "video_url_expires_at": 1788853117
  },
  "file_status": "available",
  "model": "lightx2v/LightWan2.2-A14B",
  "duration": 5,
  "resolution": "480P",
  "ratio": "16:9",
  "framespersecond": 16,
  "width": 832,
  "height": 480,
  "output_format": "mp4",
  "watermark": true
}
下载结果
VIDEO_URL=$(jq -r '.content.video_url // empty' video-task-response.json)
curl -L --fail --show-error "${VIDEO_URL}" -o generated-video.mp4

签名 URL 已包含短时效访问凭证,下载时通常不需要再次发送 wylon API Key。不要记录或公开完整签名 URL。

取消或删除任务

cURL:取消或删除
curl -sS -X DELETE \
  "https://api.wylon.cn/v1/contents/generations/tasks/${VIDEO_TASK_ID}" \
  -H "Authorization: Bearer ${WYLON_API_KEY}"

删除任务记录或取消任务可能不可恢复。调用前应确认任务 ID 和当前状态。

错误处理与生产建议

状态码常见原因建议操作
400字段类型错误或模型不支持指定参数根据当前模型限制修正请求
401403密钥无效或没有模型、任务权限检查鉴权与账户权限
404模型或任务不存在检查完整模型 ID、任务 ID 和调用环境
429请求频率、并发或容量达到限制降低请求频率并稍后重试
500503服务内部错误或模型暂不可用创建成功后优先查询原任务
沪ICP备2026010432号-1沪公网安备31010402336632号