跳转到内容

执行 文字生成视频 任务。

请求

AI 任务是异步处理的。功能支持 Webhook 时,优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名,收到 success 或 error 通知后,用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。

若功能不支持 Webhook,或您的接入方式用不了 Webhook,就请实现轮询。提交 AI 任务后,按固定间隔(例如每 10 秒)轮询状态接口,直到任务状态变为 success 或 error。

安全
BearerAuthenticationV2
正文application/json必需
modelstring

模型名称。

默认值:"youcam-video-v2"
Value:"youcam-video-v2"
promptstring, [ 1 .. 5000 ] characters必需

文字提示词,描述视频内容与视觉风格。 支持中英文,每个汉字或字母计 1 字符。

示例:"A kitten running in the moonlight."
negative_promptstring, [ 1 .. 500 ] characters

反向提示词,描述视频中要排除的内容,用于约束输出。 支持中英文。

示例:"low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions."
resolutionstring

生成视频的分辨率档位,决定清晰度(总像素数)。

默认值:"1080P"
Enum:"720P""1080P"
示例:"1080P"
ratiostring

生成视频的宽高比。

各宽高比对应的输出视频分辨率(width*height)见下表:

分辨率档位宽高比输出视频分辨率(width*height)
720P16:91280*720
720P9:16720*1280
720P1:1960*960
720P4:31104*832
720P3:4832*1104
1080P16:91920*1080
1080P9:161080*1920
1080P1:11440*1440
1080P4:31648*1248
1080P3:41248*1648
默认值:"16:9"
Enum:"16:9""9:16""1:1""4:3""3:4"
示例:"16:9"
dst_durationinteger, [ 2 .. 15 ]必需

生成视频的时长(秒)。

默认值:5
示例:5
prompt_extendboolean

开启提示词改写。开启后由大语言模型智能改写您输入的提示词,对短提示词效果更好,但耗时更长。

默认值:true
Enum:truefalse
示例:true
curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/text-to-video/youcam \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "youcam-video-v2",
    "prompt": "A kitten running in the moonlight.",
    "negative_prompt": "low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions.",
    "resolution": "1080P",
    "ratio": "16:9",
    "dst_duration": 5,
    "prompt_extend": true
  }'

响应

任务执行成功

正文application/json
statusinteger

响应状态

示例:200
dataobject
响应
{ "status": 200, "data": { "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe" } }