YUYU_C1 圖生影片

YUYU_C1 是 YUYU VIDEO 提供的圖生影片模型,以 preset_name(風格預設集)驅動輸出,依 audio 分成靜音/有聲兩種模式,並可用 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 三種 MIME 皆可),這裡為了範例簡短省略實際 base64 內容:

curl -X POST https://example.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(任務剛建立時是待派工狀態,result/files 尚無內容）：

{
  "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 字
`negative_prompt`	string	否	負向提示詞,最長 500 字
`images`	string[]	是	恰好 1 張(`size: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` 秒,僅 `audio = true` 時有效(見下方說明)
`seed`	integer	否	`>= 0`
`resolution`	—	否	`YUYU_C1` 目前不支援調整解析度,此欄位對本模型沒有效果,建議不要帶
`payload`	object	否	你自訂的透傳資料——原樣存入,查詢任務與〈回呼(Webhook)〉都會原封不動帶回,系統本身不解讀內容
`callback_url`	string	否	必須是 `https://` 開頭的網址,最長 2000 字;見〈回呼(Webhook)〉

`preset_name` 說明

preset_name 直接沿用系統原生的預設集名稱,本平台不做枚舉合法性驗證。靜音模式(audio = false)與有聲模式(audio = true)是兩套不重疊的詞彙:

靜音模式:共 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。
有聲模式:共 6 種可選值:blowjob_pov / cumshot / front_doggystyle / missionary_pov / squatting_cowgirl / undress。

送出不存在、或不屬於目前 audio 模式的 preset_name,建單當下仍會成功(201),但系統實際處理此任務時會失敗,任務轉為失敗並自動退款(見〈積分與計費〉的退款規則),不是同步的 422 錯誤。

`quality` 說明

quality 可選 low / mid / high。已知例外:有聲模式(audio = true)實際不支援 high,若送出 audio = true + quality = high 這個組合,建單當下同樣會成功,但實際處理時會失敗,任務轉為失敗並自動退款——與上方 preset_name 的情形相同,本平台不在建單當下做這個跨欄位驗證。

`duration` 說明

duration 只在 audio = true(有聲模式)時才會實際影響輸出秒數;audio = false(靜音模式)時,即使帶了 duration 也會被忽略,實際秒數由 preset_name 決定。

帶入未知的 model 值會收到 422:Unknown model alias: {model}。

`Idempotency-Key`

在 header 帶上任意字串(建議用你系統內該次請求的唯一識別碼,如訂單編號):

Idempotency-Key: order-20260711-00044

同一組 API Key + 同一個 Idempotency-Key 值,短時間內重複送出同一請求,只會建立一筆任務;之後的重複請求會回傳同一筆既有任務(不會重新扣款、不會建立第二筆任務)。適合用在你的系統有重試機制、又不希望重試造成重複扣款的場景。不帶這個 header 則每次請求都會建立新任務。

回應

成功建立回 201 Created(冪等命中既有任務則回 200 OK),內容是〈任務查詢與取件〉描述的任務物件。

錯誤情境

狀態碼	情境	內容
`422`	參數驗證失敗(缺必填、型別錯、`images` 不是恰好 1 張、`quality` 不是 `low`/`mid`/`high` 等)	Laravel 標準 `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
—	`preset_name` 不存在、不屬於目前 `audio` 模式,或 `audio=true` 搭配 `quality=high`	建單成功(`201`),但任務之後轉為失敗(`status = 30`)並自動退款,見上方說明

實際會扣多少積分、建立後如何查詢進度與取得結果,見〈任務查詢與取件〉與〈積分與計費〉。

YUYU_C1 圖生影片

完整範例

參數表

preset_name 說明

quality 說明

duration 說明

Idempotency-Key

回應

錯誤情境

`preset_name` 說明

`quality` 說明

`duration` 說明

`Idempotency-Key`