curl --request POST \
--url https://api.aiid.edu.kg/omni-video/kling-4.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"settings": {
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
},
"options": {},
"contents": [
{
"type": "prompt",
"text": "A cinematic product shot with natural motion"
},
{
"type": "refer_image",
"url": "https://example.com/reference.jpg"
},
{
"type": "feature_video",
"url": "https://example.com/motion.mp4"
}
]
}
'{
"code": 0,
"message": "SUCCEED",
"request_id": "request_example",
"data": {
"id": "task_example",
"status": "submitted",
"create_time": 1792710000000,
"update_time": 1792710000000,
"external_id": ""
}
}Kling オールインワンリファレンス
このシリーズはOpenAIの動画生成形式をサポートしています（詳細はリンク 動画生成Sora互換形式 を参照してください）。
Kling 4.0 ネイティブタスクAPI。本サイトの Bearer API Key を使用して認証します。リクエスト本文に model は不要です。settings.resolution=720p では kling-4.0、1080p では kling-4.0-1080p を使用し、デフォルトは1080pです。作成後、返された data.id を使用して GET /tasks?task_ids=タスクID を呼び出します。複数のIDはカンマで区切ります。照会結果の data は配列で、生成された動画は data[].outputs[].url にあります。
現在、プロンプト、first_frame、last_frame、refer_image、feature_video に対応する生成シナリオをサポートしています。middle_frame、base_video、element、voice、音声参照、コールバック、またはカスタム外部タスクIDはサポートしていません。空でないoptions.callback_url、空でないoptions.external_task_id、空でないcontents.id、およびその他の未サポートのフィールドは400を返します。optionsは省略するか空のオブジェクトを指定でき、watermark_info.enabled=falseを指定することもできます。ウォーターマークの有効化は現在サポートされていません。現在、動画の長さは4～30秒をサポートし、デフォルトは10秒です。3秒はサポートされていません。テキスト生成および参照シナリオのアスペクト比はデフォルトで16:9です。adaptiveを明示的に指定すると400が返されます。先頭・末尾フレームのシナリオでは、settings.aspect_ratioを明示的に指定できません。アスペクト比は最初のframe画像のサイズによって決まります。
汎用参照の contents には、空でない prompt と、サポートされているメディアを少なくとも 1 つ含める必要があります。従来の開始・終了フレームのシナリオでは first_frame、last_frame、または両方を指定できますが、処理可否は現在利用可能なモデルの機能に準拠します。機能が一致しない場合はリクエストが拒否され、フレーム画像が通常の参照画像に暗黙的に変換されることはありません。開始・終了フレームを新規に統合する場合は、画像から動画を生成するエンドポイントの使用を推奨します。開始・終了フレームは、refer_image の参照画像または feature_video の参照動画と併用できません。併用すると 400 が返されます。参照シナリオでは、refer_image の参照画像と feature_video の参照動画を組み合わせることができます。first_frame、last_frame、refer_image はそれぞれ最大 1 件、feature_video は最大 5 件指定できます。id を参照する複数参照画像のシナリオは、現在サポートされていません。
curl --request POST \
--url https://api.aiid.edu.kg/omni-video/kling-4.0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"settings": {
"resolution": "720p",
"duration": 10,
"aspect_ratio": "16:9"
},
"options": {},
"contents": [
{
"type": "prompt",
"text": "A cinematic product shot with natural motion"
},
{
"type": "refer_image",
"url": "https://example.com/reference.jpg"
},
{
"type": "feature_video",
"url": "https://example.com/motion.mp4"
}
]
}
'{
"code": 0,
"message": "SUCCEED",
"request_id": "request_example",
"data": {
"id": "task_example",
"status": "submitted",
"create_time": 1792710000000,
"update_time": 1792710000000,
"external_id": ""
}
}承認
Bearer Token を使用して認証します。
形式: Authorization: Bearer sk-xxxxxx
ボディ
- Option 1
- Option 2
過去の開始・終了フレーム互換シナリオ：first_frame、last_frame、または両方。現在利用可能なモデルの機能により制限されます。参照素材を混在させないでください。aspect_ratioを省略した場合、画角は最初のframeに従います。
空でないpromptとサポート対象のメディアを同時に含める必要があります。画像から動画生成ではfirst_frameが必須です。first_frame/last_frameはrefer_image/feature_videoと併用できません。併用した場合は400が返されます。各メディアの数量制限については、API仕様を参照してください。従来の先頭・末尾フレームリクエストは、現在利用可能なモデルの機能に基づいて検証されます。先頭・末尾フレームの新規連携には、画像から動画生成エンドポイントの使用を推奨します。
2レスポンス
成功
0