メインコンテンツへスキップ
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-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "背景を雪山のシーンに差し替える",
    "resolution": "1080P"
  }'

{
  "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-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "背景を雪山のシーンに差し替える",
    "resolution": "1080P"
  }'

{
  "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-videoedit で固定
​
video_urls
array<string>
必須
編集対象の元動画URL配列
最初の 1 本のみ使用されます
動画の制限：
  • フォーマット：mp4、mov
  • 長さ：2〜10秒
  • 解像度：幅・高さともに [240, 4096] ピクセルの範囲
  • アスペクト比：1:8 〜 8:1
  • ファイルサイズ：100MB 以下
​
prompt
string
編集指示。動画にどのような変更を加えたいかを記述、最大 5000 文字
未指定の場合、モデルはデフォルトのスタイル転送を実行します
例："人物の衣装を赤いドレスに変える"、"背景を雪山のシーンに差し替える"
​
negative_prompt
string
出力に含めたくない内容を表すネガティブプロンプト。最大 500 文字まで。
​
image_urls
array<string>
参考画像URLの配列。最大 4 枚ターゲットのスタイルや外観の指定に使用（スタイル転送の参考スタイルなど）
​
resolution
string
デフォルト:"1080P"
出力動画の解像度選択肢：
  • 720P - 標準
  • 1080P - 高解像度（デフォルト）
​
duration
integer
デフォルト:"0"
出力動画の長さ（秒）
  • 0（デフォルト）：元動画の全長を保持
  • 2-10 の整数：先頭から指定時間を切り出し
duration=0 の場合、出力動画の実時間で課金されます指定する時間は video_urls の元動画の長さを超えることはできません
​
size
string
出力画面のアスペクト比対応フォーマット：
  • 16:9 - 横向きワイド
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
未指定の場合、入力動画のアスペクト比に従います
​
prompt_extend
boolean
デフォルト:"true"
プロンプトのインテリジェントな書き換えを有効にするか短いプロンプトで効果が顕著ですが、処理時間が増加しますデフォルト：true
​
watermark
boolean
デフォルト:"false"
生成された動画に “AI生成” ウォーターマークを追加するか
  • true：ウォーターマークを追加
  • false：追加しない（デフォルト）
​
seed
integer
生成内容のランダム性を制御するシード整数範囲：≥0 の整数
  • 同一リクエストで異なるseed値を受け取ると（seedを指定しない場合など）、異なる結果が生成されます
  • 同一リクエストで同じseed値を受け取ると、類似した結果が生成されますが、完全一致は保証されません
​
metadata
object
追加パラメータオブジェクト

​
レスポンス

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

​
使用例

​
例 1：基本動画編集（最小）

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "背景を雪山のシーンに差し替える"
}

​
例 2：スタイル転送（参考画像付き）

{
  "model": "wan2.7-videoedit",
  "prompt": "参考画像のアニメ調に動画のスタイルを合わせる",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
例 3：元動画の音声を保持

重要なBGMや人物の対話がある動画に適します： 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "背景を山道に差し替える",
  "metadata": { "audio_setting": "origin" }
}

​
例 4：フルパラメータ

{
  "model": "wan2.7-videoedit",
  "prompt": "人物の衣装を赤いドレスに変える",
  "negative_prompt": "ぼやけ、歪み",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
音声処理の説明

audio_setting説明適用シーン
auto（デフォルト）編集後の動画内容に基づき、AIがマッチングする音声を再生成視覚スタイルが大きく変化し、音声も同期更新したい場合
origin元動画の音声トラックを強制保持重要なBGMや人物対話を含む動画
タスク結果の取得動画生成は非同期タスクで、送信時に task_id が返されます。タスクステータス取得 エンドポイントで生成進捗と結果を取得してください。