Skip to main content
POST
cURL

画像生成

完全なパラメータリファレンスについては、Kling 公式ドキュメントを参照してください。
このエンドポイントを使用すると、Kling の画像生成 API を通じて静止画像を作成できます。同じ非同期タスクフローで、テキストのみのリクエストと画像参照リクエストの両方をサポートします。

最初のリクエスト

まずは model_name: kling-v3promptnaspect_ratio から始めてください。参照画像、忠実度の制御、または高度なフィールドは、最初のリクエストで使用可能なタスクが返ってきた後にのみ追加してください。model_name を省略するとレガシー互換のデフォルトが使用されるため、新しい統合では kling-v3 を明示的に送信してください。

レスポンスを読む

返された task_id を保存し、その後、対応する Kling の画像クエリルートをポーリングして、task_status が終端状態に達するまで確認してください。ワークフローで永続的なストレージが必要な場合は、生成の完了後に最終アセットを自分のストレージレイヤーへコピーしてください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

Content-Type
string
デフォルト:application/json

Must be application/json.

ボディ

application/json
prompt
string
必須

Text prompt describing the image to generate. Maximum 2500 characters.

model_name
enum<string>
デフォルト:kling-v1

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
negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.

image
string

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.

image_reference
enum<string>

Reference mode for legacy image-to-image requests when image is provided.

利用可能なオプション:
subject,
face
image_fidelity
number
デフォルト:0.5

How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.

必須範囲: 0 <= x <= 1
human_fidelity
number
デフォルト:0.45

Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.

必須範囲: 0 <= x <= 1
element_list
object[]

Optional Kling element references. The total count of element references and input images must not exceed 10.

resolution
enum<string>
デフォルト:1k

Output resolution. Defaults to 1k.

利用可能なオプション:
1k,
2k
n
integer
デフォルト:1

Number of images to generate. Range: 1-9.

必須範囲: 1 <= x <= 9
aspect_ratio
enum<string>
デフォルト:16:9

Output aspect ratio (width:height).

利用可能なオプション:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL to receive task status updates when the task completes.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

レスポンス

200 - application/json

Task request accepted or an error response returned by the API.

code
必須

Response code. 0 means the task request was accepted.

message
string
必須

Response message.

data
object
必須
request_id
string

Request identifier returned when present.