Documentation

동영상 생성

Playground에서는 MiniMax 및 Doubao 동영상 모델로 비동기 동영상 작업을 만들 수 있습니다. 모델을 선택하면 해당 프로토콜, 사용 가능한 옵션과 예상 요금이 자동으로 전환됩니다.

동영상 만들기

  1. Playground를 열고 동영상을 선택합니다.
  2. 사용 가능한 MiniMax 또는 Doubao 동영상 모델과 API 키를 선택합니다.
  3. 프롬프트를 입력하고 필요하면 참고 이미지 한 장을 업로드합니다.
  4. 길이, 비율, 해상도와 시드를 설정합니다.
  5. 예상 요금을 확인하고 생성을 클릭합니다.

프롬프트는 최대 7,000자입니다. 제출 후 작업 목록에서 상태를 확인하고, 완료된 동영상을 미리 보거나 다운로드할 수 있습니다.

매개변수

매개변수MiniMaxDoubao
해상도768P480p, 720p, 1080p
길이4-15초1-60초
이미지가 없을 때 비율16:9, 4:3, 1:116:9, 4:3, 1:1
이미지가 있을 때 비율자동 맞춤자동 맞춤
시드기본값 42, 변경 가능기본값 42, 변경 가능
오디오모델에 따라 다름현재 Playground에서는 생성하지 않음

사용 가능한 옵션은 선택한 모델에 따라 달라집니다. 모델을 바꾸면 해상도 옵션과 예상 요금도 갱신됩니다.

이미지 입력

Playground에서는 작업당 이미지 한 장을 업로드할 수 있습니다. JPEG, PNG, WebP, HEIC, HEIF를 지원하며 최대 크기는 30 MB입니다. 이미지를 추가하면 비율이 자동 맞춤으로 바뀝니다. Board는 선택한 동영상 프로토콜을 통해 이미지를 전송하며 원본 이미지를 공개 URL로 저장하지 않습니다.

요금과 잔액

요금은 선택한 모델, 동영상 길이, 해상도와 플랫폼 가격 설정을 기준으로 계산됩니다. 제출 전에 표시되는 금액은 예상값이며, 작업을 만들 때 확정된 가격 규칙으로 잔액이 차감됩니다. 잔액이 부족하면 작업이 생성되지 않습니다.

동영상 작업이 실패하거나 취소되면 작업 상태에 따라 환불이 처리됩니다. 비동기 정산 동기화 중에는 사용 기록이 표시되기까지 잠시 지연될 수 있습니다.

작업 상태

상태의미
Queued요청이 접수되어 upstream 처리를 기다리는 중
Runningupstream 서비스가 동영상을 생성하는 중
SucceededBoard에 저장되어 미리 보기 또는 다운로드 가능
Failed생성 또는 결과 전송 실패. 작업 상세에서 확인
Cancelled작업이 취소되었으며 결제 상태에 따라 정산

동영상 생성은 비동기 작업입니다. upstream이 완료된 뒤에도 Board가 결과를 저장하므로, upstream에서 완료된 직후에도 잠시 Running으로 표시될 수 있습니다.

MiniMax와 Doubao

두 모델은 같은 Playground 흐름을 사용하지만 프로토콜과 매개변수 제한은 다릅니다. Board가 선택한 모델에 맞는 프로토콜을 자동으로 선택하므로 /minimax 또는 /doubao 경로를 직접 입력할 필요가 없습니다.

모델이 선택 목록에 없다면 동영상 기능이 활성화되지 않았거나, 현재 조직에 공개되지 않았거나, upstream을 사용할 수 없는 상태일 수 있습니다.