텍스트-투-비디오 작업 생성
- 공식 문서: https://platform.vidu.cn/docs/text-to-video
- 텍스트-투-비디오 작업을 생성하고 task_id를 반환합니다
- model, prompt 및 기타 매개변수로 생성을 제어합니다
Authorizations
Request Body
텍스트 프롬프트
비디오 생성을 위한 텍스트 설명입니다.
참고: 2000자를 초과할 수 없습니다
모델 이름
허용 값: viduq3-turbo, viduq3-pro, viduq2, viduq1
- viduq3-turbo: viduq3-pro 대비 생성 속도가 더 빠릅니다
- viduq3-pro: 고품질 오디오-비디오를 효율적으로 생성하며, 더 생동감 있고 입체적인 결과를 제공합니다
- viduq2: 최신 모델
- viduq1: 선명한 화면, 부드러운 전환, 안정적인 카메라 움직임
스타일
기본값 general, 허용: general, anime
general: 일반 스타일, 프롬프트로 제어
anime: 애니메이션 스타일, 애니메이션 표현에 강함, 다양한 애니메이션 스타일 프롬프트로 제어
참고: q2 모델 사용 시 이 매개변수는 적용되지 않습니다
비디오 길이, 기본값은 모델에 따라 다릅니다:
- viduq3-pro, viduq3-turbo: 기본 5초, 범위 1–16
- viduq2: 기본 5초, 범위 1–10
- viduq1: 기본 5초, 5만 허용
랜덤 시드
생략하거나 0이면 무작위 값을 사용합니다
수동 설정 시 해당 시드를 사용합니다
화면 비율
기본 16:9, 허용: 16:9, 9:16, 3:4, 4:3, 1:1
참고: 3:4, 4:3는 q2 모델에서만 지원됩니다
해상도, 기본값은 모델과 길이에 따라 다릅니다:
- viduq3-pro, viduq3-turbo (1–16초): 기본 720p, 허용 540p, 720p, 1080p
- viduq2 (1–10초): 기본 720p, 허용 540p, 720p, 1080p
- viduq1 (5초): 기본 1080p, 허용 1080p
움직임 진폭
기본 auto, 허용: auto, small, medium, large
참고: q2 모델 사용 시 이 매개변수는 적용되지 않습니다
생성된 비디오에 배경 음악을 추가할지 여부입니다.
기본 false, 허용 true, false
true이면 시스템이 사전 설정 BGM 라이브러리에서 적합한 음악을 선택해 추가합니다.
- BGM 길이 제한 없음, 비디오 길이에 맞게 자동 조정
패스스루 매개변수
처리하지 않으며 데이터 전달만 합니다
참고: 최대 1048576자
워터마크 추가 여부
- true: 워터마크 추가
- false: 워터마크 없음
참고 1: 워터마크 내용은 고정(AI 생성)이며 기본적으로 꺼져 있습니다
참고 2: 작업 조회 API의 watermarked_url로 워터마크가 있는 비디오를 조회할 수 있습니다
워터마크 위치(이미지 상 위치):
1: 왼쪽 위
2: 오른쪽 위
3: 오른쪽 아래
4: 왼쪽 아래
기본값: 3
워터마크 이미지 URL
생략 시 기본 워터마크 문구: AI 생성 콘텐츠
메타데이터 식별자(JSON 문자열), 패스스루 필드, 사용자 정의 또는 예시 형식:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
비어 있으면 기본적으로 Vidu가 생성한 메타데이터를 사용합니다
콜백 URL(POST). 작업 생성 시 설정하며, Vidu가 이 URL로 작업 상태 업데이트를 전송합니다. 본문은 작업 조회 API 응답과 동일합니다.
콜백 status 값:
- processing: 처리 중
- success: 완료(전송 실패 시 최대 3회 재시도)
- failed: 실패(전송 실패 시 최대 3회 재시도)
Vidu는 콜백 서명 인증을 사용합니다. 콜백 서명 문서를 참고하세요
Responses
성공