画像生成
POST
/kling/v1/images/generations
テキストプロンプトと任意の参照画像から画像生成タスクを作成します。
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
model_name
string
Required
モデル名。列挙値:kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1, kling-v3
prompt
string
Required
ポジティブテキストプロンプト(最大 2500 文字)
negative_prompt
string
ネガティブテキストプロンプト(最大 2500 文字)
image
string
参照画像(Base64 またはアクセス可能な画像 URL)
image_reference
string
画像参照タイプ。
列挙値:subject(キャラクター特徴参照), face(顔の似顔参照)。
face 使用時はアップロード画像に顔が 1 つのみ含まれる必要があります。
kling-v1-5 かつ image が空でない場合は必須です。
image_fidelity
number
生成時のアップロード画像の参照強度。
範囲:[0, 1]。値が大きいほど参照が強くなります。
human_fidelity
number
顔参照強度(参照画像の五官の類似度)。
image_reference が subject の場合のみ有効。
範囲:[0, 1]。値が大きいほど参照が強くなります。
resolution
string
出力画像の解像度。
列挙値:1k, 2k
1k:1K 標準
2k:2K HD
n
integer
Required
生成する画像枚数。
範囲:[1, 9]
aspect_ratio
string
出力のアスペクト比(幅:高さ)。
列挙値:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
callback_url
string
タスク完了時のコールバック URL
Responses
OK
application/json
object
task_id
string
タスク ID
task_status
string
タスクステータス