GetRouter文件
  • 繁體中文

    • 圖片

    GetRouter 為圖片生成與圖片編輯提供不同的端點。

    POST https://getrouter.ai/v1/images/generations
POST https://getrouter.ai/v1/images/edits

    傳送請求前，請先從 Models 選擇圖片模型，並查看其價格與支援的選項。

    生成圖片

    curl https://getrouter.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "以極簡黑白風格繪製 API 路由器插圖",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

    回應包含 data 陣列。根據請求與模型，每個項目可能包含託管 URL 或 Base64 編碼的圖片資料。

    Python

    from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.images.generate(
    model="MODEL_ID",
    prompt="以極簡黑白風格繪製 API 路由器插圖",
    size="1024x1024",
    n=1,
)

print(response.data[0].url or response.data[0].b64_json)

    編輯圖片

    圖片編輯使用 multipart 表單資料：

    curl https://getrouter.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=將背景替換成簡潔的攝影棚牆面" \
  -F "[email protected]" \
  -F "n=1"

    相容模型也可能接受遮罩與其他模型專屬欄位。

    常用欄位

    欄位用途
    model圖片模型 ID
    prompt描述或編輯指示
    n要求的圖片數量
    size模型支援的輸出尺寸
    quality模型專屬的品質模式
    style模型專屬的風格模式
    response_format常見值包括 url 與 b64_json

    API 也為部分模型支援供應商專屬的圖片酬載。當模型要求不同的請求主體結構時，請使用 API 參考中顯示的結構描述與範例。

    Warning

    圖片數量、尺寸、品質及編輯支援因模型而異，並會直接影響成本。批次生成前，請查看 Pricing。

    安全處理輸出

    • 請在託管 URL 到期前下載內容。
    • 將 b64_json 寫入檔案前，請先解碼。
    • 在提供生成檔案的應用程式中驗證輸出 MIME 類型。
    • 請勿僅因用戶端未能儲存回應，就重試已成功的生成請求。

    後續步驟