新接入建議使用 圖片生成 與統一
/ai/v1/images/generations 協定。本頁 OpenAI 相容及供應商適配介面仍可使用。呼叫前請查詢 模型 Schema 介面,依回傳的 path 選擇協定並讀取該項的 request.schema,不要依賴陣列位置。目前模型清單
本清單表示模型目前已上線,不代表所有模型共用相同輸入欄位。請依模型 Schema 回傳的
path 選擇端點,再讀取該項的 request.schema。API
OpenAI
支援的模型:
- gpt-image-2(支援透過 OpenAI 相容圖片編輯端點呼叫,模型 ID 必須寫成
gpt-image-2,不可簡寫為image2) - gpt-image-1
- dall-e-3
呼叫方法:
gpt-image-2
這是 OpenAI 圖片編輯模型,呼叫時請填寫完整模型名gpt-image-2,不可簡寫為 image2。該端點返回 b64_json 時,可按下面範例保存為 edited.png。
Ideogram V3
支援的模型:
- V3
- V3 以下版本(V_2、V_1 等)為舊介面,暫不支援
- 返回的連結需要開啟代理網路才能取得
呼叫方法:
Stability
支援的模型:
- Stable-Diffusion-3-5-Large
呼叫方法:
Google Imagen
支援的模型:
- imagen-4.0-ultra-generate-001
- imagen-4.0-generate-001
- imagen-4.0-fast-generate-001
不支援 gemini 系列
呼叫方法:
錯誤回應與相容錯誤碼
本節適用於本頁的 Legacy/v1/images/* 介面。新版 /ai/v1/images/* 使用獨立的
圖片錯誤合約。兩套介面的回應結構和
錯誤碼需要分別處理。
Legacy 圖片介面的一般錯誤回應如下。param 是選填欄位,tid 通常附加在 message
末尾,不會單獨回傳:
提交 HTTP 5xx 錯誤回饋
僅在請求回傳 HTTP
5xx 時提交回饋,並附上 message 中的 tid。