跳到正文
HopBase 文檔
登入控制台

圖片總覽

用 OpenAI Images 相容介面生成和編輯圖片。

用途端點
Base URLhttps://api.hop-base.com/v1
生成圖片POST /v1/images/generations
編輯圖片POST /v1/images/edits
查詢非同步任務GET /v1/images/tasks?task_id=…

調用 GPT Image 需要「GPT Image 全系」分組的金鑰；其中 gpt-image-2.5-flare 與 gpt-image-2.5-sunburst 也可以用「GPT 官方直連(Azure)」分組的金鑰，同步返回 Base64。其他系列見「選擇系列」。

三行生成第一張圖

在控制台「API 金鑰」頁用「GPT Image 全系」分組建立金鑰。不含該分組的金鑰（例如只有 Codex Plus / Codex Pro）調 gpt-image-* 會返回 404；也可以在已有金鑰上加上這個分組。

把 sk-你的金鑰 換成新金鑰後執行。curl 範例需要先安裝 jq。

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一隻柴犬坐在櫻花樹下，日系水彩風格",
    "size": "1024x1024"
  }' \
  | jq -r '.data[0].b64_json' | base64 --decode > result.png

圖片以 Base64 放在 data[].b64_json，解碼後就是 PNG。單張通常 15–40 秒，客戶端讀超時請設為不少於 300 秒（原因見 GPT Image）。

選擇系列

各系列分屬不同套餐分組，能調通其中一個的金鑰不代表能調通其他。參數、返回與報錯見各系列頁。

系列特點調用方式參考圖上限官方價（代表型號）
GPT Image支援 mask 局部重繪；按 token 計費同步；可非同步16 張（官方）$5 / $30/ 百萬 tokens
Gemini 生圖1K–4K 檔位，任意比例 寬x高同步；可非同步14 張（官方）$0.1344起/ 張
Seedream返回 24 小時有效的 URL 或 b64_json同步；Lite / 4.5 可串流14 張$0.045起/ 張
Grok Imagine 生圖不使用 size，返回臨時 URL僅同步2 張$0.02/ 張
可靈生圖多個型號，含擴圖與多參考圖非同步0–10 張，按型號$0.0294/ 張
Midjourney每次固定出 4 張非同步1 張$0.0067起/ 張

發付費請求前，用實際要使用的金鑰調 GET /v1/models，從返回結果裡取完整模型 ID。各系列的分組見系列頁開頭的速查表。

共用規則

鑑權與請求體

所有端點都使用 Authorization: Bearer sk-你的金鑰，Base URL 是 https://api.hop-base.com/v1。整個請求體上限 60 MB，超過返回 413。

Gemini 生圖也用 OpenAI Images 結構。不要傳 Gemini native generateContent payload，HopBase 會根據所選模型自動完成協議適配。

同步與非同步

方式適用系列取結果
同步（預設）GPT Image、Gemini、Seedream、Grok回應體的 data[]
非同步（加 Prefer: respond-async）GPT Image、GeminiGET /v1/images/tasks?task_id=…
一律非同步可靈、MidjourneyGET /v1/video/tasks/{task_id}

生成 2K / 4K 大圖時建議用非同步，可避免長時間請求被 CDN 超時中斷。Seedream 忽略 Prefer 照常同步返回。

傳參考圖

系列欄位與寫法
GPT Image/v1/images/edits 的 image，或 multipart image[]
Geminigenerations 的 image / images；「Gemini 全系（含生圖）」也可用 edits
Seedreamgenerations 的 image；本地檔案走 edits multipart
Grok Imagine/v1/images/edits 的 image 或 image[]
可靈 / Midjourneyimages: [{"url": …}] 或 [{"file_id": …}]

URL 必須能被服務端取得，不是瀏覽器登入後才能存取的頁面，也不能指向內網地址。Data URL 須是完整編碼，MIME 與圖片匹配，例如 data:image/png;base64,iVBORw0KGgo…。

asset:// 僅用於Seedance 2.0 素材庫，不能用於任何圖片系列。

計費

實際扣費 = 官方價 × 分組倍率，以控制台「使用記錄」為準。參數不合規的 400 在生成前返回，不計費；各系列的計費單位見系列頁。

單價見各模型卡與登入後的模型廣場。

下一步

本頁目錄

三行生成第一張圖選擇系列共用規則鑑權與請求體同步與非同步傳參考圖計費下一步