# Z Image API Z Image テキストから画像生成向け完全 API リファレンスです。 ## モデルバリアント この API は 1 つのモデルバリアントに対応しています: | モデル | ID | 説明 | |-------|-----|-------------| | **Z Image** | `z-image` | 高速なテキストから画像生成 | ## クイック比較 | 機能 | Z Image | |---------|---------| | 入力 | テキストプロンプト | | 出力 | 生成画像 1 枚 | | アスペクト比 | 複数の比率に対応 | | 解像度 | 幅/高さの比率値から算出 | | `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`。 ポーリング成功レスポンスでは、生成画像 URL が `data.task_result.images[].url` に公開されます。 ## ベストプラクティス - `width` と `height` にはピクセル寸法ではなく比率値を使用します。 - プロンプトは説明的にしつつ、被写体、ライティング、構図に集中させます。 - テスト中に再現可能な生成結果が必要な場合は、固定の `seed` を使用します。