メインコンテンツへスキップ
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",
    "prompt": "夕日に照らされた海沿いの道路、スローモーションのカメラプッシュイン、映画のような映像",
    "resolution": "1080P",
    "duration": 8,
    "size": "16:9"
  }'

{
  "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",
    "prompt": "夕日に照らされた海沿いの道路、スローモーションのカメラプッシュイン、映画のような映像",
    "resolution": "1080P",
    "duration": 8,
    "size": "16:9"
  }'

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

​
認証

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

​
モードルーティング

wan2.7 はテキストから動画および画像から動画の統一エンドポイントです。バックエンドは受信したパラメータに基づいて自動的にモードを判定します。両モードの料金は同一です：
条件ルーティング先モード説明
image_urls / image_with_roles / video_urls のいずれかが指定画像から動画先頭フレーム / 先頭・最終フレーム / 動画継続
上記パラメータがいずれも未指定テキストから動画テキスト説明のみから動画生成

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名。wan2.7 で固定
​
prompt
string
動画内容の説明、最大 5000 文字
  • テキストモード（画像/動画なし）：必須
  • 画像モード：任意だが、カメラワークやアクションの指示のため推奨
例："猫が草原で蝶を追いかける、晴天、スローモーション"
​
image_urls
array<string>
画像URLの配列。指定すると自動的に画像モードに入ります
  • 1 枚：先頭フレームから動画
  • 2 枚：先頭・最終フレームから動画（1枚目が先頭、2枚目が最終）
image_with_roles とどちらか一方を使用
image_urls と audio_url は競合するため、同時に指定することはできません
​
image_with_roles
array<object>
ロール付き画像の配列。image_urls の代わりに使用し、各画像のロールを精密に指定各オブジェクトのフィールド：
  • url (string)：画像URL（http/httpsに対応）
  • role (string)：画像ロール、first_frame（先頭フレーム）/ last_frame（最終フレーム）、デフォルト first_frame
例：
[
  { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" },
  { "url": "https://cdn.example.com/end.jpg", "role": "last_frame" }
]
image_with_roles と audio_url は競合するため、同時に指定することはできません
​
video_urls
array<string>
動画URLの配列。指定すると動画継続モードに入ります（最初の1本のみ使用）
video_urls と audio_url は競合するため、同時に指定することはできません
動画の制限：
  • フォーマット：mp4、mov
  • 長さ：2〜10秒
  • 解像度：幅・高さともに [240, 4096] ピクセルの範囲
  • アスペクト比：1:8 〜 8:1
  • ファイルサイズ：100MB 以下
​
negative_prompt
string
ネガティブプロンプト。含めたくない内容を記述、最大 500 文字例："ぼやけ、歪み、低品質"
​
resolution
string
デフォルト:"1080P"
動画解像度選択肢：
  • 720P - 標準
  • 1080P - 高解像度（デフォルト）
​
duration
integer
デフォルト:"5"
動画の長さ（秒）対応範囲：2〜15 秒デフォルト：5
​
size
string
デフォルト:"16:9"
画面のアスペクト比。テキストモードのみ有効（画像/動画なしの場合）対応フォーマット：
  • 16:9 - 横向きワイド（デフォルト）
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
画像モードではこのパラメータは無視され、アスペクト比は入力画像により自動決定されます
​
audio_url
string
カスタムオーディオURL
  • テキストモード：動画のBGMとして使用
  • 画像モード：駆動音声として使用、画面のアクションに同期
形式：wav / mp3、長さ2〜30秒、ファイルサイズ≤15MB
audio_url は video_urls、image_urls、image_with_roles と競合するため、これらと同時に指定することはできません
​
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",
  "prompt": "夕日に照らされた海沿いの道路、スローモーションのカメラプッシュイン、映画のような映像"
}

​
例 2：テキストから動画（フルパラメータ）

{
  "model": "wan2.7",
  "prompt": "猫が草原で蝶を追いかける、晴天、スローモーション",
  "negative_prompt": "ぼやけ、歪み、低品質",
  "resolution": "1080P",
  "duration": 8,
  "size": "16:9",
  "audio_url": "https://cdn.example.com/bgm.mp3",
  "prompt_extend": true,
  "watermark": false,
  "seed": 42
}

​
例 3：先頭フレームから動画

{
  "model": "wan2.7",
  "prompt": "人物がゆっくり立ち上がり、カメラに向かって歩いてくる",
  "image_urls": ["https://cdn.example.com/person.jpg"],
  "resolution": "1080P",
  "duration": 8
}

​
例 4：先頭・最終フレームから動画

{
  "model": "wan2.7",
  "prompt": "カメラが海辺から山頂へゆっくり移動",
  "image_urls": [
    "https://cdn.example.com/beach.jpg",
    "https://cdn.example.com/mountain.jpg"
  ],
  "resolution": "1080P",
  "duration": 10
}
2枚指定の場合：1枚目が先頭フレーム、2枚目が最終フレーム。image_with_roles で精密指定も可能。

​
例 5：動画継続

{
  "model": "wan2.7",
  "prompt": "前進を続け、カメラが追随",
  "video_urls": ["https://cdn.example.com/clip.mp4"],
  "resolution": "1080P",
  "duration": 8
}

​
例 6：画像 + 駆動音声

{
  "model": "wan2.7",
  "prompt": "人物が音楽のリズムに合わせて動く",
  "image_urls": ["https://cdn.example.com/dancer.jpg"],
  "audio_url": "https://cdn.example.com/beat.mp3",
  "resolution": "1080P",
  "duration": 8
}

​
モード選択ガイド

要件推奨方法
テキストのみから動画生成prompt のみ指定（画像/動画なし）
画像を”動かす”image_urls に1枚指定
開始・終了シーンを制御image_urls に2枚指定（先頭+最終）
既存動画を延長video_urls に動画を指定
画像を音楽に合わせる画像 + audio_url
タスク結果の取得動画生成は非同期タスクで、送信時に task_id が返されます。タスクステータス取得 エンドポイントで生成進捗と結果を取得してください。