圖片請求建構器 | HopBase 文檔

選模型、填參數，即時得到可執行的請求和程式碼。只列出該模型支援的參數；上下限、列舉值和報錯原文都取自閘道校驗程式碼。

model必填

GPT Image 全系

prompt必填不能為空（首尾空白不計） · 官方上限 32,000 字元

size選填邊長為 16 的倍數，單邊 ≤ 3840

總像素 655,360–8,294,400，長短邊比 ≤ 3:1。不合規會在生成前回傳 400，不計費。

quality選填預設 auto，原樣轉發

檔位越高，輸出 token 越多，費用越高

n選填1–10（官方範圍）

部分分組只支援 1 張，批次產生前請先確認

background選填預設 auto

output_format選填預設 png

moderation選填預設 auto；low 不會關閉安全檢查

image選填1–16 張（官方上限）

0 / 16

帶參考圖時改用 POST /v1/images/edits；遠端 URL 單張 ≤ 25 MiB，且須回傳 image/*

傳入不生效

response_format
一律回傳 b64_json，請省略
partial_images
不支援漸進式圖片事件，請省略

POST /v1/images/generations

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "白底商品主圖：一隻不鏽鋼保溫杯，柔和棚拍光，主體置中",
    "size": "1024x1024"
  }'

$0.006–0.0528

auto 檔未實測，按 low–high 區間 × 1 張（輸出 $30/百萬 token）

官方價估算，實際扣費 = 官方價 × 分組倍率

查看此模型的 SchemaJSON Schema 全部模型索引 OpenAPI 3.1

…

機器可讀規格

建構器使用的規格同時以 JSON Schema（draft 2020-12）和 OpenAPI 3.1 發布。程式設計 AI 可以按 Schema 產生並自檢請求：必填項、型別、上下限、列舉值、條件規則（例如 Gemini 各檔位的張數上限）和會回傳 400 的欄位都在裡面；x-hopbase 另附可用分組、官方價和資料出處。

/spec/models/index.json：全部生圖模型的規格索引
/openapi.json：POST /v1/images/generations 與 POST /v1/images/edits，請求本文引用各模型的 Schema

資料來源：參數規格取自 spec/openai.json、spec/gemini.json、spec/seedance.json（由閘道外掛從校驗程式碼匯出）與 spec/official.json；價格取自公開定價介面快照。費用均按官方價估算，實際扣費 = 官方價 × 分組倍率。