メインコンテンツへスキップ
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "海辺を走るコーギー、映画のような雰囲気、夕暮れの光",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "海辺を走るコーギー、映画のような雰囲気、夕暮れの光",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
認証

​
Authorization
string
必須
すべてのインターフェースで Bearer Token による認証が必要ですAPI キーの取得：API キー管理ページ にアクセスして API キーを取得してください使用時にはリクエストヘッダーに追加します：
Authorization: Bearer YOUR_API_KEY

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名対応モデル：
  • kling-3.0-turbo - Kling 3.0 Turbo
​
prompt
string
必須
テキストプロンプト上流の制限は 3072 文字以内、2500 文字以内を推奨します。例："海辺を走るコーギー、映画のような雰囲気、夕暮れの光"
​
first_frame_image
string
画像 URL または Base64 に対応。
最初のフレーム画像の上流制限：
  • 形式：.jpg / .jpeg / .png
  • サイズ：≤ 50MB
  • 幅・高さ：≥ 300px
  • アスペクト比：1:2.5 ~ 2.5:1
​
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比選択可能な値：
  • 16:9 - 横向き
  • 9:16 - 縦向き
  • 1:1 - 正方形
デフォルト値：16:9
テキストから動画でのみ有効。画像から動画の場合はこのフィールドは無効で、動画の比率は最初のフレーム画像によって決まります。
​
resolution
string
デフォルト:"720p"
動画の解像度選択可能な値：
  • 720p
  • 1080p
デフォルト値：720p
​
duration
integer
デフォルト:"5"
動画の長さ（秒）値の範囲：3〜15（最短 3 秒、最長 15 秒）デフォルト値：5⚠️ 注意： 純粋な数値（例：6）を入力してください。引用符を付けるとエラーになります
​
watermark
boolean
ウォーターマークを追加するかどうか明示的に渡された場合のみ上流に送信されます。渡さない場合はウォーターマークは追加されません。

​
テキストから動画 vs 画像から動画

システムは first_frame_image が指定されているかどうかに応じて生成モードを自動判定します。最初のフレーム画像がある場合は画像から動画、ない場合はテキストから動画となり、ユーザーが明示的に宣言する必要はありません。
パラメータテキストから動画画像から動画
prompt✅ 必須✅ 任意（空欄の場合は最初のフレーム画像のみで生成）
first_frame_image❌ 渡さない✅ 必須
aspect_ratio✅ 任意❌ 無効（比率は最初のフレーム画像によって決まる）
resolution✅ 任意✅ 任意
duration✅ 任意（3〜15）✅ 任意（3〜15）
watermark✅ 任意✅ 任意

​
レスポンス

​
code
integer
レスポンスステータスコード。成功時は 200
​
data
array
返されるデータ配列

​
使用シーン

​
シーン 1：テキストから動画（1080P）

{
  "model": "kling-3.0-turbo",
  "prompt": "海辺を走るコーギー、映画のような雰囲気、夕暮れの光",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

​
シーン 2：テキストから動画（縦向き 720P）

{
  "model": "kling-3.0-turbo",
  "prompt": "東京・渋谷の交差点、雨の夜、濡れた地面に映るネオン、傘をさして行き交う人々",
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 10
}

​
シーン 3：画像から動画（最初のフレーム画像）

{
  "model": "kling-3.0-turbo",
  "prompt": "カメラがゆっくりとズームイン、人物が微笑む",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "720p",
  "duration": 5
}

​
シーン 4：最初のフレーム画像のみで動画生成（プロンプトなし）

{
  "model": "kling-3.0-turbo",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "1080p",
  "duration": 5
}

​
シーン 5：マルチショット分割（テキストから動画）

{
  "model": "kling-3.0-turbo",
  "prompt": "ショット 1,2,海辺をコーギーが走る；ショット 2,3,カメラがズームインして人物が微笑む；",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}
タスク結果のクエリ動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 インターフェースを使用して生成の進捗と結果をクエリしてください。