Kling で画像を生成する
CometAPI 経由で Kling の画像を生成します: POST /kling/v1/images/generations は、プロンプト駆動の画像作成と画像参照生成をサポートします。
画像生成
最初のリクエスト
まずはmodel_name: kling-v3、prompt、n、aspect_ratio から始めてください。参照画像、忠実度の制御、または高度なフィールドは、最初のリクエストで使用可能なタスクが返ってきた後にのみ追加してください。model_name を省略するとレガシー互換のデフォルトが使用されるため、新しい統合では kling-v3 を明示的に送信してください。
レスポンスを読む
返されたtask_id を保存し、その後、対応する Kling の画像クエリルートをポーリングして、task_status が終端状態に達するまで確認してください。ワークフローで永続的なストレージが必要な場合は、生成の完了後に最終アセットを自分のストレージレイヤーへコピーしてください。承認
Bearer token authentication. Use your CometAPI key.
ヘッダー
Must be application/json.
ボディ
Text prompt describing the image to generate. Maximum 2500 characters.
Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.
kling-v1, kling-v1-5, kling-v2, kling-v2-1, kling-v3 Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.
Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
Reference mode for legacy image-to-image requests when image is provided.
subject, face How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.
0 <= x <= 1Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.
0 <= x <= 1Optional Kling element references. The total count of element references and input images must not exceed 10.
Output resolution. Defaults to 1k.
1k, 2k Number of images to generate. Range: 1-9.
1 <= x <= 9Output aspect ratio (width:height).
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 Watermark options.
Webhook URL to receive task status updates when the task completes.
Optional user-defined task ID for your own tracking. Must be unique per account.