跳转到内容

執行 AI 文字轉影片任務。

请求

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必需

描述影片內容與視覺風格的文字提示。 支援中文與英文。每個字或字母計為一個字元。

示例:"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" } }