メインコンテンツへスキップ
POST
/
v1
/
midjourney
/
generations
/
video
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "the cat slowly turns its head to the camera",
    "image_urls": [
      "https://example.com/cat.png"
    ],
    "motion": "high",
    "batch_size": 4
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "the cat slowly turns its head to the camera",
    "image_urls": [
      "https://example.com/cat.png"
    ],
    "motion": "high",
    "batch_size": 4
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
画像から動画(i2v)。固定 FAST モードで speed 次元はありませんテキストから動画(t2v)には非対応で、最初のフレームが必須です。長さは約 5 秒で固定です。
項目内容
actionVIDEO
課金midjourney@video / midjourney@video-720p実課金 = 単価 × batch_size
必須image_urls(最初のフレーム)または task_id(SUCCESS の imagine を再利用)

パラメータ

フィールド必須既定説明
promptstringいいえ(親を継承)動画プロンプト。空の場合は task_id が必須
image_urlsstring[]最初のフレーム(1 枚、≤ 12 MiB)。task_id とどちらか一方
task_idstringSUCCESS の imagine を再利用。image_urls とどちらか一方
indexintいいえimagine の 4 枚のどれを最初のフレームにするか(03task_id と併用)
video_typestringいいえvid_1.1_i2v_480解像度(下表)。720 を含むと @video-720p 課金
animate_modestringいいえmanualmanual / autoautotask_id + index が必須
motionstringいいえhighlow / high。動きの大きさ、課金に影響なし
batch_sizeintいいえ11 / 2 / 4 のいずれか、他の値は 1 扱い。課金 × N
end_urlstringいいえ終了フレーム。設定すると video_type が自動的に start_end_* に昇格

video_type の有効値

解像度モード課金
vid_1.1_i2v_480480p基本 i2v(既定)midjourney@video
vid_1.1_i2v_720720p基本 i2vmidjourney@video-720p
vid_1.1_i2v_start_end_480480p起止フレーム(end_url 設定時に自動昇格)midjourney@video
vid_1.1_i2v_start_end_720720p起止フレーム(end_url 設定時に自動昇格)midjourney@video-720p
extend 系の値は受け付けません。上の表に記載の video_type のみ対応します。

リクエスト例

シンプルな i2v(自前の最初のフレーム、batch 4):
{
  "prompt": "the cat slowly turns its head to the camera",
  "image_urls": ["https://example.com/cat.png"],
  "motion": "high",
  "batch_size": 4
}
起止フレーム transition(end_url で自動的に start_end に昇格):
{
  "prompt": "transition smoothly from sunrise to sunset",
  "image_urls": ["https://example.com/sunrise.jpg"],
  "end_url": "https://example.com/sunset.jpg",
  "video_type": "vid_1.1_i2v_720"
}

レスポンス

送信で task_id を返し、GET /v1/tasks/{task_id} をポーリングします。SUCCESS 時に video_url(先頭)と video_urlslength === batch_size、batch=1 でも 1 要素)を含みます:
{
  "id": "task_xxx",
  "status": "SUCCESS",
  "action": "VIDEO",
  "mode": "FAST",
  "video_url": "https://r2.example.com/video-0.mp4",
  "video_urls": [
    "https://r2.example.com/video-0.mp4",
    "https://r2.example.com/video-1.mp4"
  ]
}

注意

  • テキストから動画(t2v)には非対応image_urls または task_id が必須で、なければ 400 を返します。両方は同時に指定できません。
  • 固定 FAST モードで speed 次元はありません(課金表の @video-fast / @video-turbo は決して命中しません)。
  • batch_size1 / 2 / 4 で厳密に検証されます。batch=4 は 4 倍課金、予算を抑えるなら batch=1
  • animate_mode=autotask_id + index の両方が必須です。
  • 最初 / 終了フレームは各 ≤ 12 MiB。