Muse Video

Muse Video는 Meta Superintelligence Labs의 동영상 모델입니다. 요청 한 번으로 프롬프트, 또는 프롬프트와 최대 9장의 참조 이미지에서 7가지 화면비 중 하나로 약 10초의 720p 사운드 포함 클립을 만듭니다. 요청을 보내고 반환된 태스크 ID를 보관한 뒤 완성된 동영상을 태스크에서 읽어 오세요. 참조 이미지는 URL로 전달합니다.

모델 ID

현재 가격은 모델 페이지에서 확인하세요.

간단한 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_ratio": "16:9"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/videos/generations

응답은 완성된 동영상이 아니라 태스크({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요.

파라미터

이 목록에 없는 필드는 요청을 전달하기 전에 삭제되며, 오류를 일으키거나 출력에 영향을 주지 않습니다. 첫 프레임과 마지막 프레임, 참조 동영상, 참조 오디오, 연장, 시드, 네거티브 프롬프트 설정은 없습니다. callback_url은 사용할 수 없으니 태스크를 폴링하세요.

참조 이미지

image_urls에 이미지 최대 9장을 전달하고 prompt에 움직임을 설명하세요. Muse Video는 이를 참조 이미지로 사용합니다. 클립은 참조 이미지와 가까운 모습을 유지하지만 첫 프레임이 픽셀 단위 복사본은 아닙니다. aspect_ratio를 생략하면 클립은 참조 이미지의 화면 형태를 따릅니다.

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

미디어 입력

각 참조 이미지는 공개 HTTP(S) URL로 전달합니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. PNG, JPEG 또는 WebP 이미지를 사용하며, 모든 참조 이미지의 원본 파일 크기 합계가 11 MB 이하여야 합니다. 이 제한을 넘으면 접수 후 태스크가 실패하며 과금되지 않습니다.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. Muse Video는 클립당 단일 요금입니다:

cost = price per clip × 1

가격에 초 수를 곱하지 않습니다. 텍스트만 있는 요청과 참조 이미지가 있는 요청, 모든 화면비의 비용이 같습니다. 태스크 접수 시 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 태스크는 과금되지 않습니다.

출력 스키마

제출하면 태스크가 반환됩니다:

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

태스크 조회

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status가 completed 또는 failed가 될 때까지 10~20초마다 폴링하세요. 폴링 중 네트워크 타임아웃이 났다고 생성이 실패한 것은 아닙니다. 태스크 ID를 보관하고 다시 확인하세요. 진행 상황을 보려고 태스크를 새로 만들지 마세요.

완료된 태스크

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

저희 테스트에서 클립은 AAC 오디오 트랙이 포함된 10.0초 MP4(H.264) 파일로, 16:9는 1280 × 720, 9:16은 720 × 1280, 16:9 화면 형태의 참조 이미지는 1248 × 704로 제출 후 약 100–200초 만에 도착했습니다.

오류

태스크가 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 태스크는 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

제출 자체가 타임아웃된 경우에는 다시 보내기 전에 태스크 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.

팁

• 피사체, 동작, 카메라 움직임, 조명과 원하는 소리를 설명하세요. 오디오는 화면과 함께 생성됩니다.
• Muse Image로 정지 이미지를 만든 뒤 여기로 URL을 전달해 움직이게 하세요.
• 세로 동영상은 aspect_ratio: "9:16" 또는 세로 참조 이미지를 보내세요.
• 지어낸 자막이 들어가지 않도록 no text를 추가하세요.

관련 자료

• Muse Video Playground와 가격
• Muse Image API 레퍼런스
• OpenAPI 다운로드
• 복사 가능한 Markdown