圖像 API — 選擇模型與端點
比較 GPT Image 2 / 2.5、Gemini Flash Image 與 Seedream 圖像端點。GPT 參考圖像請使用 multipart 編輯，並遵循各模型自身的輸入格式。
圖像 API 總覽
APIMaster 在 https://apimaster.ai/v1 下提供圖像 API。圖像轉圖像並非所有模型都使用單一通用輸入格式。 請先選擇模型，再使用其文件所述的端點與參考欄位。
模型與端點指南
| 模型 | 文字轉圖像 | 圖像轉圖像 | 指南 |
|---|---|---|---|
gpt-image-2 |
JSON /images/generations |
Multipart /images/edits、image / image[] 檔案 |
GPT Image 2 / 2.5 |
gpt-image-2.5-sunburst |
JSON /images/generations |
Multipart /images/edits、image / image[] 檔案 |
GPT Image 2 / 2.5 |
gpt-image-2.5-flare |
JSON /images/generations |
Multipart /images/edits、image / image[] 檔案 |
GPT Image 2 / 2.5 |
gemini-3.1-flash-image-preview |
JSON /images/generations |
JSON /images/generations 搭配 image_urls |
Gemini Flash Image |
gemini-nano-banana-2.1 |
JSON /images/generations |
multipart /images/edits / JSON image_urls |
Nano Banana 2.1 |
grok-imagine-image-2.0 |
JSON /images/generations |
JSON /images/generations 搭配 image_urls（最多 5 個） |
Grok Imagine Image 2.0 |
doubao-seedream-5-0-pro-260628 |
JSON /images/generations |
JSON /images/generations 搭配 image |
Seedream 5.0 Pro |
midjourney-v8.2 |
非同步 /midjourney/generations |
JSON image_urls 參考 |
Midjourney v8.2 / Niji 7 |
midjourney-niji-7 |
非同步 /midjourney/generations |
JSON image_urls 參考 |
Midjourney v8.2 / Niji 7 |
對於 Grok Imagine Image 2.0，請使用同步 /images/generations 搭配 image_urls。不支援用戶端非同步路徑與 /images/edits 路徑；請參閱 Grok Imagine Image 2.0 指南。
對於 GPT 參考圖像，請將實際檔案上傳至 /images/edits 以取得圖像回應，或上傳至 /images/edits/async 以取得任務回應；請勿複製 Gemini 或 Seedream 的 JSON 格式。在提示中提及參考並不算上傳。GPT Image 2.5 是獨立的模型系列，不是 GPT Image 2 的別名。
Midjourney v8.2 與 Niji 7 透過 /midjourney/generations 建立非同步任務；請輪詢 GET /tasks/{task_id}。參數與範例請參閱 Midjourney v8.2 / Niji 7 指南。
驗證與回應
- 在主控台建立金鑰；傳送
Authorization: Bearer YOUR_API_KEY。 - JSON 生成呼叫使用
Content-Type: application/json。進行 multipart 編輯時，讓 HTTP 用戶端產生 Content-Type 與 boundary。 - 同步圖像回應包含
data[]，內含url或b64_json；請處理這兩種格式。請及時下載暫時性 URL。 - 選填欄位、參考限制、尺寸與價格取決於模型與可用路由。請查看模型指南與市集。
非同步工作
POST /images/generations/async、POST /images/edits/async 與 GET /tasks/{task_id}?model=MODEL_ID 為支援的模型提供以任務為基礎的圖像工作流程。這並非所有圖像作業的通用模式：
- 對於 GPT Image 2、Sunburst 與 Flare，文字轉圖像請使用 JSON
generations/async，編輯請使用 multipartedits/async。上傳與同步編輯相同的檔案，然後使用提交帳號與相同模型 ID 進行輪詢。 - 生成或編輯可能會在非同步提交傳回任務 ID 之前完成；請勿假設提交是即時的。請勿在輪詢現有任務時重新提交該任務。完成狀態可以是
succeeded、success或completed；追蹤的結果使用字串url，而舊版結果可能包含 URL 陣列。 - Gemini 有其自身的非同步生成流程；參考輸入請遵循其指南。
- Seedream 5.0 Pro 使用同步生成，且不支援
/images/generations/async。
請參閱模型指南，以取得完整的 cURL/Python 範例、輪詢狀態與疑難排解。單憑 HTTP 200 回應並無法驗證參考圖像的保真度。