生成前年齡檢查

建立圖生影片、全能參考影片、圖片任務時,只要有放 images,系統會先檢查圖中人物的年齡,確認沒有未成年人才會開始生成。沒有放 images 的請求(例如文字生圖、文生影片)不會檢查。

年齡檢查不另外收費。任務被擋下時,這筆任務扣的積分會全額退回。

流程

1. 建立任務時照常扣積分,任務狀態是 2(年齡檢查中)。
2. 每張圖片分別偵測,全部完成後依下表判斷:

結果	條件	處理方式
成年	每張圖的每張臉都判定為成年	任務變成 0(排隊中),照常生成
無法確定	有任何一張臉的年齡接近成年邊界,或圖中找不到人臉	沒帶 age_declared: true:任務失敗(face_age_uncertain),全額退款。有帶:照常生成
未成年	有任何一張臉判定為未成年	任務失敗(face_age_minor),全額退款。帶了 age_declared 也一樣會被擋

偵測通常幾秒內完成。完成前任務會停在 2,這段期間可以取消任務,積分全額退回。

age_declared 參數

欄位	型別	必填	說明
age_declared	boolean	否	帶 true 表示你確認圖中人物都已成年。只會放行「無法確定」的情況,「未成年」一律擋下

建議做法:第一次送出時先不要帶 age_declared。如果收到 face_age_uncertain,請你的使用者確認照片中的人物都已成年,再帶 age_declared: true 重新送出。

curl -X POST https://yuyuvideo.com/api/tasks/video-generation \
  -H "X-Api-Key: sk-live-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YUYU_M1",
    "prompt": "a person walking on the beach",
    "images": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."],
    "age_declared": true
  }'

失敗時的 error_code

被擋下的任務 status 會是 30。查詢任務或收到〈回呼(Webhook)〉通知後,可以從 error_code 看原因:

error_code	原因	建議處理
face_age_minor	圖中有未成年人	換一張圖片,不能再送同一張
face_age_uncertain	無法確認人物已成年(年齡接近成年邊界,或找不到人臉)	確認人物都已成年後,帶 age_declared: true 重新送出
face_check_failed	偵測服務暫時無法使用	稍後再送一次

以上三種情況都已全額退款。