列出生圖模型與能力
格式同 OpenRouter `GET /api/v1/images/models`,已套用組織 ∩ API Key 允許清單。 `supported_parameters` 是每個參數的描述子(`enum` 給允許值、`range` 給上下限、`boolean` 表示支援); 沒列出的參數代表不支援。所有模型都接受 `stream: true`。
/v1/images/models格式同 OpenRouter GET /api/v1/images/models,已套用組織 ∩ API Key 允許清單。
supported_parameters 是每個參數的描述子(enum 給允許值、range 給上下限、boolean 表示支援);
沒列出的參數代表不支援。所有模型都接受 stream: true。
Authorization
bearerAuth 在 Authorization 標頭帶入 Workspace API Key:
Authorization: Bearer sk-hakila-...
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/images/models"{ "data": [ { "id": "google/gemini-3.1-flash-image", "name": "Google: Nano Banana 2 (Gemini 3.1 Flash Image)", "architecture": { "input_modalities": [ "text", "image" ], "output_modalities": [ "image" ] }, "supported_parameters": { "resolution": { "type": "enum", "values": [ "512", "1K", "2K", "4K" ] }, "aspect_ratio": { "type": "enum", "values": [ "1:1", "16:9", "9:16" ] }, "n": { "type": "range", "min": 1, "max": 4 }, "input_references": { "type": "range", "min": 0, "max": 14 } }, "supports_streaming": true, "endpoints": "/v1/images/models/google/gemini-3.1-flash-image/endpoints" } ]}編輯圖片(OpenAI 形狀) POST
對齊 [OpenAI Images edits](https://platform.openai.com/docs/api-reference/images/createEdit)。 接受 `multipart/form-data`(`image`/`image[]` 檔案、選填 `mask`)或 JSON(`images: [{image_url}]`、`mask: {image_url}`)。 單張圖片上限 50 MB、整個請求上限 64 MB;網址只接受 https 或 data URL。 串流事件為 `image_edit.completed`。
查詢生圖模型的計價與可透傳參數 GET
格式同 OpenRouter `/api/v1/images/models/{author}/{slug}/endpoints`。`pricing` 為 USD 計價項目, 另附 Hakila 點數版本 `pricing_points` 與預算預估用的 `max_cost_per_image`。 `allowed_passthrough_parameters` 是 `provider.options` 可以帶的欄位。