YUYU_C1 圖生影片

YUYU_C1 用範本(preset_name)決定影片的動作與風格,可選擇靜音或有聲兩種模式,並用 quality 調整畫質。

POST /api/tasks/video-generation
X-Api-Key: sk-live-xxxx
Content-Type: application/json
Idempotency-Key: 選填,見下方說明

完整範例

images 要放 base64 格式的 data URI,支援 PNG、JPEG、WebP。範例中省略了實際的 base64 內容:

curl -X POST https://yuyuvideo.com/api/tasks/video-generation \
  -H "X-Api-Key: sk-live-xxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-20260716-00044" \
  -d '{
    "model": "YUYU_C1",
    "prompt": "a woman waving at the camera, cinematic lighting",
    "images": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."],
    "preset_name": "some_preset",
    "quality": "mid",
    "audio": true,
    "duration": 10,
    "payload": { "external_order_id": "order-20260716-00044" },
    "callback_url": "https://example.com/webhooks/yuyu-video"
  }'

建立成功會回傳 201 Created 和任務資料。這時任務還在排隊,files 是空的。credits 是這次扣除的積分,範例中的數字僅供參考:

{
  "public_id": "01K1M2N3P4Q5R6S7T8V9W0XY14",
  "type": 1,
  "status": 0,
  "credits": 15,
  "params": {
    "model": "YUYU_C1",
    "prompt": "a woman waving at the camera, cinematic lighting",
    "images": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."],
    "preset_name": "some_preset",
    "quality": "mid",
    "audio": true,
    "duration": 10,
    "payload": { "external_order_id": "order-20260716-00044" },
    "callback_url": "https://example.com/webhooks/yuyu-video"
  },
  "error_code": null,
  "error_message": null,
  "created_at": "2026-07-16T08:00:00.000000Z",
  "finished_at": null,
  "files_expire_at": null,
  "files_expired": false,
  "files": []
}

接下來如何查詢進度、下載影片,請見〈任務查詢與取件〉。

參數表

欄位	型別	必填	說明
`model`	string	是	填 `YUYU_C1`
`prompt`	string	是	影片描述,最多 10000 字
`images`	string[]	是	只能放 1 張圖片,格式為 base64 data URI(`data:image/{png\|jpeg\|webp};base64,...`)
`preset_name`	string	是	範本名稱,見下方說明
`quality`	string	是	畫質:`low` / `mid` / `high`,見下方說明
`audio`	boolean	否	是否有聲音,預設 `false`(靜音)
`duration`	integer	否	`5` / `10` / `15` / `20` 秒,只在有聲模式有效,見下方說明
`seed`	—	否	不支援,帶了會回傳 `422`
`resolution`	—	否	不支援,帶了會回傳 `422`
`payload`	object	否	自訂資料,例如你的訂單編號。系統不會讀取或修改,查詢任務和 Webhook 通知時會原樣帶回
`callback_url`	string	否	任務結束時要通知的網址,需以 `https://` 開頭,最多 2000 字。詳見〈回呼(Webhook)〉

model 填了不存在的模型會回傳 422:Unknown model alias: {model}。

表格沒有列出的參數(age_declared 除外,詳見〈生成前年齡檢查〉)帶了會回傳 422,不會被忽略。

`preset_name` 說明

靜音模式和有聲模式各有一套範本,兩套不能混用:

靜音模式(audio = false),共 52 種:anal / back_doggystyle / blowjob / blowjob_69 / blowjob_reverse / breast_massage / breast_massage_nude / butt_smothering / cock_worship / cum_in_mouth / dildo_masturbation / double_blowjob / double_penetration / ejaculation / facefuck / facefuck_pov / facial_cumshot / footjob / front_doggystyle / fuck_machine / full_nelson / handjob / masturbation / missionary_pov / missionary_sideview / nipple_play / nude_posing / orgasm / orgasm_controller / pronebone / pussy_closeup / remix_blowjob / remix_breast_massage / remix_cowgirl / remix_cunnilingus / remix_doggystyle / remix_double_blowjob / remix_dress_dance / remix_handjob / remix_kiss / remix_seated_blowjob / reverse_cowgirl / shoejob / spitroast / squatting_cowgirl / throatpie / tiktok_trend / titjob / titty_flash / triple_dicked / twerk / undress。
有聲模式(audio = true),共 6 種:blowjob_pov / cumshot / front_doggystyle / missionary_pov / squatting_cowgirl / undress。

建立任務時不會檢查範本名稱。如果填了不存在的範本,或範本不屬於目前的模式,任務仍會建立成功(201),但之後會處理失敗,並自動退回積分。

`quality` 說明

quality 可選 low / mid / high。

有聲模式(audio = true)不支援 high。如果送出 audio = true 加上 quality = high,任務一樣會建立成功,但之後會處理失敗,並自動退回積分。

`duration` 說明

duration 只在有聲模式(audio = true)決定影片長度。靜音模式下,影片長度由範本決定,帶了 duration 也不會生效。

計費則一律依照你送出的 duration 計算,靜音模式也一樣:每 5 秒為一個計費單位(例如 10 算 2 個單位),沒帶 duration 時算 1 個單位。詳見〈積分與計費〉。

`Idempotency-Key`

用來避免重複建立任務。在 header 帶上一組自訂字串,建議用你系統裡的訂單編號這類不會重複的值:

Idempotency-Key: order-20260711-00044

用同一把 API 金鑰、同一個 Idempotency-Key,在短時間內重複送出請求,只會建立一筆任務,也只扣一次積分。之後的重複請求會回傳 200 OK 和原本那筆任務。

不帶這個 header 的話,每次請求都會建立新任務。

錯誤情境

狀態碼	原因	回應內容
`422`	參數有誤,例如缺少必填欄位、型別錯誤、`images` 不是 1 張、`quality` 不是 `low` / `mid` / `high`	`errors` 欄位會列出每個欄位的錯誤原因
`422`	`model` 填了不存在的模型	`{ "message": "Unknown model alias: {model}" }`
`402`	積分不足	`{ "message": "Insufficient credits to complete this charge." }`
`429`	排隊中的影片任務太多	`{ "message": "Too many pending tasks of this type; please retry later." }`。可以依回應的 `Retry-After` header 決定多久後再試
—	範本不存在、範本不屬於目前模式,或有聲模式搭配 `quality = high`	建立成功(`201`),但任務之後會失敗(`status = 30`),並自動退回積分

扣款規則請見〈積分與計費〉。

YUYU_C1 圖生影片

完整範例

參數表

preset_name 說明

quality 說明

duration 說明

Idempotency-Key

錯誤情境

`preset_name` 說明

`quality` 說明

`duration` 說明

`Idempotency-Key`