AI 任务是异步处理的。功能支持 Webhook 时,优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名,收到 success 或 error 通知后,用收到的 task_id 查询任务结果。配置与校验的细节请见 Webhook 接入指南。
若功能不支持 Webhook,或您的接入方式用不了 Webhook,就请实现轮询。提交 AI 任务后,按固定间隔(例如每 10 秒)轮询状态接口,直到任务状态变为 success 或 error。
安全
BearerAuthenticationV2
文字提示词,描述视频内容与视觉风格。 支持中英文,每个汉字或字母计 1 字符。
示例:"A kitten running in the moonlight."
反向提示词,描述视频中要排除的内容,用于约束输出。 支持中英文。
示例:"low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions."
生成视频的宽高比。
各宽高比对应的输出视频分辨率(width*height)见下表:
| 分辨率档位 | 宽高比 | 输出视频分辨率(width*height) |
|---|---|---|
| 720P | 16:9 | 1280*720 |
| 720P | 9:16 | 720*1280 |
| 720P | 1:1 | 960*960 |
| 720P | 4:3 | 1104*832 |
| 720P | 3:4 | 832*1104 |
| 1080P | 16:9 | 1920*1080 |
| 1080P | 9:16 | 1080*1920 |
| 1080P | 1:1 | 1440*1440 |
| 1080P | 4:3 | 1648*1248 |
| 1080P | 3:4 | 1248*1648 |
默认值:"16:9"
Enum:"16:9""9:16""1:1""4:3""3:4"
示例:"16:9"
- https://yce-api-01.makeupar.comhttps://yce-api-01.makeupar.com/s2s/v2.0/task/text-to-video/youcam
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
}'响应
{ "status": 200, "data": { "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe" } }