APIMart
비디오

Muse Video API

Muse Video API는 프롬프트 또는 최대 9장의 참조 이미지로 동영상을 생성합니다. 작업 API에서 약 10초 길이의 소리가 포함된 720p MP4 영상 한 편을 받으세요.

동영상 생성

서비스 하이라이트

  • 공식 할인
  • 종량제
  • 고속 & 저지연
Input
참조 이미지

선택 사항: 참고 이미지 최대 9장, 총 11 MiB. 자동 비율은 참고 이미지 비율을 따릅니다.

Output

아직 생성 기록이 없습니다.

Muse Video API 요금

숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.

모델골드 가격현재 가격플래티넘 가격다이아몬드 가격공식 가격절약률
muse-video-ext0.24Credits(~$0.024)/회0.228Credits(~$0.0228)/회0.216Credits(~$0.0216)/회0.3Credits(~$0.03)/회20%

* 실제 비용은 최종 출력에 따라 달라집니다.

Muse Video API로 제작 시작

Muse Video API는 프롬프트 또는 최대 9장의 참조 이미지로 동영상을 생성합니다. 작업 API에서 약 10초 길이의 소리가 포함된 720p MP4 영상 한 편을 받으세요.

Muse Video API 지원 기능

생성 모드, 입력 조건과 출력 사양을 확인하세요.

Muse Video API 텍스트 동영상 생성

프롬프트에 피사체, 동작과 카메라 움직임을 설명하세요. 참조 이미지 없이 텍스트로 동영상을 생성할 수 있습니다.

Muse Video API 참조 이미지

프롬프트와 함께 최대 9장을 전송하세요. URL, Data URI, base64를 지원하며 원본 이미지의 총 크기는 11 MiB 이하여야 합니다.

Muse Video의 7가지 화면 비율

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3을 지원합니다. 자동 선택 시 aspect_ratio를 생략하여 참조 이미지의 화면 비율를 따릅니다.

Muse Video Model의 720p 유성 영상

요청마다 약 10초 길이의 소리 있는 MP4 한 편을 생성합니다. 실제 길이와 크기는 결과 파일에서 확인하세요.

muse-video-ext 모델 호출

전체 모델 ID muse-video-ext를 /v1/videos/generations에 보내 생성 작업을 시작하세요.

Muse Video API 비동기 작업

한 번 제출한 뒤 작업 ID를 저장하고 상태를 조회하세요. 중단된 제출을 재시도할 때는 같은 멱등 키와 요청 본문을 사용합니다.

Muse Video API 가격

생성 전에 계정의 실시간 가격을 확인하세요. 최종 작업 비용과 계정 청구서가 기준입니다. 각 요청은 영상 한 편 단위로 과금되며 초 수를 곱하지 않습니다.

Muse Video 결과 다운로드 및 보관

작업이 completed가 되면 결과 URL을 읽으세요. 응답에 expires_at이 있으면 해당 시간 전에 다운로드하거나 저장하세요.

Muse Video API 활용 사례

제작 목적에 맞는 브리프를 작성하고 결과를 검토하세요.

Muse Video API 스토리보드

동작과 카메라 움직임을 설명하여 장면 브리프를 짧은 영상 콘셉트로 검토하세요.

Muse Video 상품 스토리

참조 이미지와 프롬프트로 상품 장면을 탐색하고 사용 전에 외관, 움직임과 소리를 확인하세요.

Muse Video API 캠페인 영상

하나의 메시지를 중심으로 장면을 구성하고 편집 도구에서 제목과 다른 소재를 추가하세요.

muse-video-ext 참조 기반 장면

참조 이미지에 맞춰 피사체와 카메라 움직임을 설명하세요. 첫 프레임이 픽셀 단위로 일치하는 것은 보장하지 않습니다.

Muse Video 소셜 동영상

지원되는 세로, 정사각형 또는 가로 비율을 선택하고 영상과 소리가 게시 위치에 적합한지 검토하세요.

Muse Video API 동영상 도구

제출, 상태 조회와 MP4 재생을 통합하세요. 작업 ID를 저장하면 중단 후 조회를 재개할 수 있습니다.

Muse Video API 키 발급 및 시작 방법

키를 만들고 브리프를 준비한 뒤 제작 결과를 정리하세요.

1

Muse Video API 키 받기

APIMart에 로그인하고 API Keys에서 키를 만드세요. 키는 서버에 보관하고 브라우저 코드나 공개 저장소에 넣지 마세요.

2

명확한 제작 지침 준비

원하는 결과와 사용 맥락을 설명하세요. 수정본을 비교할 수 있도록 지침을 요청과 함께 저장하세요.

3

결과 검토 및 통합

사용 전에 제작 지침과 결과를 비교하세요. 다음 제작 단계에 활용할 소재를 정리하세요.

Muse Video API 예제와 통합

muse-video-ext를 /v1/videos/generations에 제출하고 작업 ID를 저장한 뒤 GET /v1/tasks/{task_id}로 결과를 조회하세요.

  1. 1

    Muse Video API 인증

    키를 서버에 보관하고 Authorization: Bearer <key>를 보내세요. 새 생성 작업마다 Idempotency-Key를 만드세요.

  2. 2

    muse-video-ext 작업 제출

    /v1/videos/generations에 model과 prompt를 POST하고 기본 응답의 data[0].task_id를 저장하세요. 중단 후 재시도할 때 같은 키와 본문을 사용하세요.

  3. 3

    Muse Video 결과 가져오기

    GET /v1/tasks/{task_id}로 completed 또는 failed까지 조회하세요. 성공 시 data.result.videos[0].url[0], 실패 시 data.error.message를 읽습니다. 로컬 시간 초과는 작업 실패가 아닙니다.

    요청과 응답 상세 내용은 Muse Video API 문서를 확인하세요.

POST /v1/videos/generations
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "muse-video-ext",
    "prompt": "Waves gently wash over a beach at sunset, the camera pans slowly, natural ocean sound, no text",
    "n": 1,
    "aspect_ratio": "16:9",
    "duration": 10,
    "resolution": "720p"
  }'

Muse Video API 매개변수

매개변수타입필수 여부기본값설명
modelstring필수기본값: —필수 모델 식별자: muse-video-ext.
promptstring필수기본값: —앞뒤 공백 제거 후 비어 있지 않은 문자열. 중국어와 영어를 지원하며 참조 이미지 유무와 무관하게 필수입니다.
image_urlsstring[]선택기본값: —최대 9개의 이미지 URL, Data URI 또는 base64. 원본 합계는 11 MiB 이하이며 참조가 없으면 생략하세요.
aspect_ratiostring선택기본값: —1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3. 자동은 생략하며 "auto"를 보내지 않습니다. 참조가 없으면 16:9, 있으면 참조 화면 비율를 따릅니다.
ninteger선택기본값: 1숫자 1만 지원합니다. 요청마다 결과 하나를 반환합니다.
durationinteger | string선택기본값: 1010, "10", "10s"만 지원하며 숫자 10을 권장합니다. 실제 재생 길이는 다를 수 있습니다.
resolutionstring선택기본값: 720p720p만 지원합니다. 소문자 720p를 보내거나 생략하세요.
nsfw_checkboolean선택기본값: false제출 전 플랫폼 콘텐츠 검사를 활성화합니다. 제출 성공이 모든 심사 통과를 보장하지는 않습니다.

Muse API 둘러보기

프로젝트에 필요한 콘텐츠 유형에 맞는 Muse 페이지를 선택하세요.

Muse Image API

Muse Video API 자주 묻는 질문

Muse Video API란 무엇인가요?

APIMart에서 텍스트나 참조 이미지로 동영상을 생성하는 API입니다. muse-video-ext는 약 10초의 소리 있는 720p MP4 영상 한 편을 반환합니다.

Muse Video API는 어떤 모델 ID를 사용하나요?

요청의 model 값에 -ext를 포함한 전체 muse-video-ext를 사용하세요.

Muse Video API 키는 어떻게 받나요?

APIMart에 로그인하고 API Keys에서 키를 만드세요. 서버에 보관하고 제출과 조회에 Authorization: Bearer <key>를 사용하세요.

Muse Video은 참조 이미지를 몇 장 지원하나요?

0~9장, 원본 합계 11 MiB까지 지원합니다. image_urls로 URL, Data URI 또는 base64를 보내며 참조 이미지가 있어도 프롬프트는 필수입니다.

Muse Video API는 어떤 비율을 지원하나요?

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3입니다. 자동은 aspect_ratio 생략을 뜻하며 참조 이미지가 있으면 그 화면 비율를, 없으면 16:9를 사용합니다.

Muse Video 길이, 해상도나 소리를 바꿀 수 있나요?

약 10초, 720p, 소리 포함 사양입니다. duration: 10과 resolution: "720p"를 사용하거나 생략하세요. audio: false는 거부되며 실제 길이는 파일에서 확인합니다.

Muse Video API는 첫·마지막 프레임이나 연장을 지원하나요?

별도의 첫 프레임, 마지막 프레임, 참조 동영상, 참조 오디오와 연장 기능은 없습니다. 참조 이미지는 image_urls로 전송하세요.

Muse Video API 작업이 페이지 대기 시간을 넘으면 어떻게 하나요?

작업 ID를 보관하고 나중에 다시 조회하세요. 브라우저 시간 초과나 폴링 중지는 서버 작업 취소가 아니므로 자동으로 새 생성 요청을 보내지 마세요.

Muse Video API 가격은 어떻게 계산하나요?

생성 전에 계정의 실시간 가격을 확인하세요. 최종 작업 비용과 계정 청구서가 기준입니다. 각 요청은 영상 한 편 단위로 과금되며 초 수를 곱하지 않습니다.

Muse Video 결과를 보관할 수 있나요?

필요한 파일을 다운로드하거나 저장하세요. expires_at이 반환되면 해당 시간 전에 보관하고, 링크 만료 시 자동으로 새 유료 생성을 요청하지 마세요.