Image
Kling Image 4.0
Kling Image 4.0で2Kまたは4Kの画像を生成できます。名前付き参照画像を使い、単一画像のバリエーションまたはつながりのあるシリーズを作成して、完成した画像のURLをポーリングで取得します。
POST /v1/images/generations に、モデルID kling-image-4-0 を指定したJSONリクエストを送信します。返されたタスクIDを保存してください。同じエンドポイントで、テキストのみの指示と参照画像を使った指示の両方を受け付けます。
簡単な例
このリクエストでは、正方形の2K静止画を1枚生成します。APIキーは環境変数 SEEDROUTER_API_KEY に保存してください。
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'エンドポイントとヘッダー
POST https://api.seedrouter.ai/v1/images/generations にJSONを送信し、Content-Type: application/json と Authorization: Bearer YOUR_API_KEY を指定します。キーはサーバー上で管理してください。
パラメーター
| フィールド | 型 | 値とデフォルト |
|---|---|---|
model | 文字列、必須 | kling-image-4-0 |
contents | 配列、必須 | プロンプト1つと参照画像0~10枚。 |
contents[].type | 文字列、必須 | prompt または refer_image。 |
contents[].text | 文字列 | プロンプトでは必須です。英語の上限は50,000文字、英語以外の上限は21,000文字です。複数言語が混在する場合、それぞれの上限に対する使用割合の合計を1以下にしてください。 |
contents[].url | 文字列 | 各参照画像に必須です。アクセス可能なHTTP(S) URLを指定してください。JPEGまたはPNG形式で、サイズは30 MB以下にしてください。縦横それぞれ300ピクセル以上で、幅と高さの比率は2:5~5:2の範囲である必要があります。 |
contents[].id | 文字列 | 参照画像に任意で付ける一意の名前です。プロンプト内では @name と記述してください。 |
settings.result_type | 文字列 | 独立した画像を生成する場合は single(デフォルト)、関連する画像を生成する場合は series を指定します。 |
settings.n | 整数 | 独立した画像を1~9枚生成します。デフォルトは1枚です。singleモードでのみ使用します。 |
settings.series_amount | 整数または文字列 | seriesモードでは画像を2~10枚生成します。デフォルトは4枚です。5~10枚の場合、プロンプトは最大20,000文字に対応し、すべての参照を名前で指定する必要があります。各参照画像は判読可能で、20 MB以下である必要があります。singleモードではこのフィールドは無視され、2~10の整数または文字列 auto を指定できます。 |
settings.resolution | 文字列 | 2k(デフォルト)または 4k。 |
settings.aspect_ratio | 文字列 | auto(デフォルト)、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9。 |
options.watermark_info.enabled | 真偽値 | 任意です。false のみ指定できます。 |
参照写真からシリーズを生成
例のURLを、製品写真の公開URLに置き換えてください。この例では、つながりのある画像を3枚生成します。各フレームの指示は同じプロンプト内に記述してください。
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}すべての画像を取得
POSTレスポンスから id をコピーして TASK_ID に設定します。同じキーを使ってこのエンドポイントをポーリングし、タスクのステータスが completed または failed になるまで確認してください。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"完了したら、output.data[].url 内のすべてのURLを確認してください。1つのタスクから複数の画像が返されることがあります。ステータス確認が中断された場合は、元のIDでもう一度検索してください。処理の流れについてはタスクのリファレンス、エラーコードについてはエラー一覧をご覧ください。
料金
合計料金は、指定した解像度で生成する出力画像の枚数に出力単価を掛けた金額に、入力画像1枚ごとの参照画像料金を加えて算出します。4K画像を4枚、参照画像を2枚使う場合、4K出力4枚分と参照画像2枚分の料金がかかります。失敗したリクエストには料金がかかりません。現在の料金をご覧ください。
エラーとヒント
入力が無効な場合、リクエストエラーが返されます。プロンプトの記載漏れ、参照IDの重複、未対応の解像度やシリーズ設定がないか確認してください。最初の呼び出しでタスクIDが返された場合は、再送信が必要か判断する前に、そのIDを照会してください。
複数の参照画像を使う場合は、対象ごとに異なる名前を付け、それぞれの参照画像がどの視覚的特徴を示すのかをモデルに伝えてください。カメラの指示とショットの順序はプロンプトに記述します。Kling Image 4.0のプレイグラウンドとOpenAPIスキーマをご覧ください。
