# Z Image API Z Image 文生圖生成的完整 API 參考。 ## 模型版本 此 API 支援一個模型版本: | 模型 | ID | 說明 | |-------|-----|-------------| | **Z Image** | `z-image` | 快速文生圖生成 | ## 快速比較 | 功能 | Z Image | |---------|---------| | 輸入 | 文字提示詞 | | 輸出 | 單張生成圖像 | | 長寬比 | 支援多種比例 | | 解析度 | 由寬高比例值推導 | | `seed` | 可选 | ### 支援的長寬比 `width:height` 組合必須是以下之一: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image(文生圖) ### 端點 ``` POST /api/v1/image/task ``` ### 請求參數 #### 必需 | 參數 | 類型 | 說明 | |-----------|------|-------------| | `model_name` | string | 必须为 `"z-image"` | | `prompt` | string | 圖像生成提示詞 | | `width` | number | 寬度比例值(例如 `16:9` 中的 `16`) | | `height` | number | 高度比例值(例如 `16:9` 中的 `9`) | #### 可選 | 參數 | 類型 | 說明 | |-----------|------|-------------| | `seed` | number | 範圍 `[0, 2147483647]` 內的隨機種子。使用 `null` 或 `0` 表示隨機生成。 | ### 請求範例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## 回應格式 提交回應: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` 使用 `GET /api/v1/image/{task_id}` 輪詢。任務狀態包括:`submitted`、`processing`、`succeed`、`failed`。 成功的輪詢回應會在 `data.task_result.images[].url` 下提供生成圖像 URL。 ## 最佳實務 - `width` 和 `height` 使用比例值,而不是像素尺寸。 - 保持提示詞有描述性,同時聚焦主體、光線和構圖。 - 測試時需要可重現生成結果時,使用固定的 `seed`。