建立圖片任務
POST /api/tasks/image-generation
X-Api-Key: sk-live-xxxx
Content-Type: application/json
Idempotency-Key: 選填,見下方說明
用文字描述或參考圖片生成圖片。目前提供三個模型,各有不同用途:
| 模型 | 用途 | 輸入圖片 | 圖片尺寸 |
|---|---|---|---|
| YUYU_C1 | 套用風格範本,用參考圖生成新圖,可調整畫質 | 可不放,最多使用前 2 張 | 不可調整 |
| YUYU_M3 | 只用文字生成全新圖片 | 不需要,放了會回傳 422 |
可用 width / height 設定,最大 1024 |
| YUYU_M4 | 依文字指令修改一張現有圖片 | 必須放 1 張要修改的圖片 | 可用 width / height 設定,最大 1024 |
怎麼選:
- 想用參考圖套用特定風格:選
YUYU_C1 - 沒有圖片,只用文字生成:選
YUYU_M3 - 想修改一張現有圖片:選
YUYU_M4
三個模型都使用同一個 API,用 model 參數指定模型。各模型的參數和範例請看對應頁面。
注意:只要請求中有放 images(包括用不到圖片的 YUYU_M3),生成前都會先偵測圖中人物的年齡,偵測到未成年人時,任務會被擋下並全額退款。建立任務時也可以帶 age_declared 參數,詳見〈生成前年齡檢查〉。