影像生成
使用統一目錄中支援影像能力的 Model ID 生成圖片。
使用影像生成功能前,請在模型目錄中確認所選模型支援的介面、尺寸、輸出方式和計費單位。
請求端點
支援相容影像生成介面的模型使用:
POST https://api.vergora.ai/v1/images/generations模型採用其他介面時,請遵循對應模型說明,不要直接沿用本頁請求。
請求範例
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一幅簡潔的城市晨景插畫",
"size": "YOUR_SUPPORTED_SIZE"
}請求欄位
| 欄位 | 說明 |
|---|---|
model | 必須是支援影像生成的 Model ID |
prompt | 描述主體、場景、構圖和期望效果 |
size | 使用所選模型支援的尺寸或比例 |
| 其他參數 | 數量、品質、參考圖等參數只在模型明確支援時使用 |
參考圖
用於修改或重繪現有圖片的模型,透過下面的介面接收一張或多張參考圖:
POST https://api.vergora.ai/v1/images/edits參考圖有兩種傳法。模型接受哪一種、最多幾張,以模型頁為準。
- 作為檔案。 用
multipart/form-data傳送請求,把圖片檔案放在image欄位裡,與model、prompt一起提交。 - 作為連結或已上傳的檔案。 傳送 JSON,使用
images陣列。每一項可以是公開連結、POST /v1/uploads回傳的 key,或者data:URI:
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "把這張照片變成水彩畫",
"images": [
"https://cdn.example.com/photo.jpg",
"uploads/u42/20261112/0123…cdef.png"
]
}如何上傳檔案以及相應的限制,見影片生成裡的「上傳參考檔案」。
讀取結果
結果可能以圖片網址、編碼內容或任務狀態回傳,具體方式取決於模型介面:
- 檢查回應狀態和回傳結構。
- 依介面說明讀取圖片或任務識別碼。
- 如果回傳任務識別碼,使用該介面提供的查詢方式檢查狀態。
- 保存請求或任務識別碼,便於追查失敗原因和核對費用。
「請求已提交」不表示圖片已經生成完成。
儲存圖片
將生成結果下載或儲存到自己的儲存空間中。臨時網址的有效期限和存取要求以實際回應說明為準。結果可能包含敏感的存取參數,分享前應檢查連結是否適合公開。
費用與重試
影像請求可能按張數、尺寸、品質或其他單位計費。以模型價目和請求紀錄為準。逾時後先檢查現有請求或任務狀態,避免重複生成和重複費用。