메인 콘텐츠로 건너뛰기
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_idstring△—SUCCESS인 imagine 재사용. image_urls와 둘 중 하나
indexint아니오—imagine 4장 중 어느 것을 첫 프레임으로 할지(0~3, task_id와 함께)
video_typestring아니오vid_1.1_i2v_480해상도 등급(아래 표). 720 포함 시 @video-720p 과금
animate_modestring아니오manualmanual / auto. auto는 task_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_urls(length === 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_size는 1 / 2 / 4로 엄격히 검증됩니다. batch=4는 4배 청구되므로 예산에 민감하면 batch=1을 사용하세요.
  • animate_mode=auto는 task_id + index가 모두 필요합니다.
  • 첫 / 종료 프레임은 각각 ≤ 12 MiB.