メインコンテンツへスキップ
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": "wan2.7-r2v",
    "prompt": "この人物が車が行き交う通りを歩いている",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-r2v",
    "prompt": "この人物が車が行き交う通りを歩いている",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

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

​
認証

​
Authorization
string
必須
すべてのAPIエンドポイントでBearer Token認証が必要ですAPIキーの取得：APIキー管理ページからAPIキーを取得してくださいリクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名。wan2.7-r2v で固定
​
prompt
string
必須
動画内容の説明、最大 5000 文字複数画像/動画の場合、「画像1」「画像2」「動画1」などの番号で参考素材を指定（入力順）例："画像1の人物が画像2のシーンに入り、周りを見回す"
​
image_with_roles
array<object>
ロール付き画像の配列。video_urls と少なくとも片方を指定各オブジェクトのフィールド：
  • url (string)：画像URL
  • role (string)：画像ロール
    • reference_image - 参考画像（デフォルト）
    • first_frame - 先頭フレーム指定（指定すると size パラメータは無効となり、先頭フレーム画像のアスペクト比が適用されます）
  • reference_voice (string、任意)：参考キャラクターの音声サンプルURL。生成動画内のキャラクターボイスの制御に使用
例：
[
  {
    "url": "https://cdn.example.com/character.jpg",
    "role": "reference_image",
    "reference_voice": "https://cdn.example.com/voice_sample.mp3"
  },
  { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
]
​
video_urls
array<string>
参考動画URLの配列。最大 5 本（画像+動画の合計 ≤ 5）image_with_roles と少なくとも片方を指定
動画の制限：
  • フォーマット：mp4、mov
  • 長さ：1〜30秒
  • 解像度：幅・高さともに [240, 4096] ピクセルの範囲
  • アスペクト比：1:8 〜 8:1
  • ファイルサイズ：100MB 以下
​
negative_prompt
string
出力に含めたくない内容を表すネガティブプロンプト。最大 500 文字まで。
​
resolution
string
デフォルト:"1080P"
動画解像度選択肢：
  • 720P - 標準
  • 1080P - 高解像度（デフォルト）
​
duration
integer
デフォルト:"5"
動画の長さ（秒）対応範囲：2〜15 秒デフォルト：5
参考素材に動画が含まれる場合：[2, 10] の範囲の整数参考素材に動画が含まれない場合：[2, 15] の範囲の整数
​
size
string
デフォルト:"16:9"
画面のアスペクト比対応フォーマット：
  • 16:9 - 横向きワイド（デフォルト）
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
image_with_roles で first_frame を指定した場合、このパラメータは無視され、先頭フレーム画像のアスペクト比が適用されます
​
prompt_extend
boolean
デフォルト:"true"
プロンプトのインテリジェントな書き換えを有効にするか短いプロンプトで効果が顕著ですが、処理時間が増加しますデフォルト：true
​
watermark
boolean
デフォルト:"false"
生成された動画に “AI生成” ウォーターマークを追加するか
  • true：ウォーターマークを追加
  • false：追加しない（デフォルト）
​
seed
integer
生成内容のランダム性を制御するシード整数範囲：≥0 の整数
  • 同一リクエストで異なるseed値を受け取ると（seedを指定しない場合など）、異なる結果が生成されます
  • 同一リクエストで同じseed値を受け取ると、類似した結果が生成されますが、完全一致は保証されません

​
レスポンス

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

​
使用例

​
例 1：単一参考画像（最小）

{
  "model": "wan2.7-r2v",
  "prompt": "この人物が車が行き交う通りを歩いている",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" }
  ]
}

​
例 2：複数参考画像

{
  "model": "wan2.7-r2v",
  "prompt": "画像1の人物が画像2のシーンに入り、画像3のポーズを真似る",
  "image_with_roles": [
    { "url": "https://cdn.example.com/person.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/background.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/pose.jpg", "role": "reference_image" }
  ],
  "resolution": "1080P",
  "duration": 8,
  "size": "16:9"
}

​
例 3：参考動画ベースの生成

{
  "model": "wan2.7-r2v",
  "prompt": "参考動画のスタイルで海辺の夕日シーンを生成",
  "video_urls": ["https://cdn.example.com/style_reference.mp4"],
  "resolution": "720P",
  "duration": 8
}

​
例 4：先頭フレーム指定 + 参考画像

{
  "model": "wan2.7-r2v",
  "prompt": "参考人物がこの位置から前方へ歩き出す",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
  ],
  "resolution": "1080P",
  "duration": 8
}

​
例 5：参考画像 + 参考音声（精密）

{
  "model": "wan2.7-r2v",
  "prompt": "この人物が通りを歩きながら話す",
  "image_with_roles": [
    {
      "url": "https://cdn.example.com/character.jpg",
      "role": "reference_image",
      "reference_voice": "https://cdn.example.com/voice_sample.mp3"
    }
  ],
  "resolution": "1080P",
  "duration": 10
}

​
画像参照ルール

複数参考画像がある場合、prompt 内で番号を使って参照：
  • 1枚目 → 「画像1」または「1枚目の画像」
  • 1本目の動画 → 「動画1」または「1本目の動画」
タスク結果の取得動画生成は非同期タスクで、送信時に task_id が返されます。タスクステータス取得 エンドポイントで生成進捗と結果を取得してください。