Kling Omni 画像タスクを作成する
CometAPI の POST /kling/v1/images/omni-image を使用して、prompt と reference-image 入力で Kling Omni Image タスクを作成します。
task_id を返します。生成された画像 URL が利用可能になるまで、Kling Omni 画像タスクを取得する を使ってタスクをポーリングしてください。
リクエスト形式を選ぶ
- 単一画像生成:
prompt,image_list,resolution,result_type: single,n,aspect_ratioを送信します - 透かし付き出力: クエリレスポンスで透かし付き結果 URL が必要な場合は、
watermark_info.enabled: trueを追加します - Model ID: デフォルトのルートを使うには
model_nameを省略するか、kling-image-o1やkling-v3-omniなど検証済みの Omni Image model ID を送信します
image フィールドを持つ image_list の各項目を使用します。プロンプトではインデックスでそれらを参照でき、たとえば最初の項目には <<<image_1>>>、2 番目の項目には <<<image_2>>> を使います。
タスクの流れ
タスクを作成する
POST /kling/v1/images/omni-image を送信し、返された data.task_id を保存します。タスクを照会する
data.task_status が succeed または failed になるまで、GET /kling/v1/images/omni-image/ をポーリングします。画像を保存する
data.task_result.images[].url を自分のストレージにコピーします。結果フィールド
成功したクエリレスポンスは、生成された画像をdata.task_result.images に返します。各項目には次のものが含まれる場合があります。
承認
Bearer token authentication. Use your CometAPI API key.
ヘッダー
Must be application/json.
ボディ
Text prompt for the generated image. The prompt can reference images with <<<image_1>>>, <<<image_2>>>, and matching indexes from image_list. Maximum length is 2,500 characters.
Optional model ID for this Omni Image request. Omit this field to use the route default.
Reference images that the prompt can cite with <<<image_1>>>, <<<image_2>>>, and so on. Keep the total number of reference images within the provider limits for the selected model.
Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.
1k, 2k, 4k Use single for a single-image task.
single Number of single-image results to generate. Range: 1 to 9.
1 <= x <= 9Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.
Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.
User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.