이미지-투-비디오 작업 생성

POST

/ent/v2/img2video

• 공식 문서: https://platform.vidu.cn/docs/image-to-video
• 이미지-투-비디오 작업을 생성하고 task_id 또는 작업 세부 정보를 반환합니다
• 요청 매개변수로 생성 동작을 제어합니다

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

텍스트 프롬프트
비디오 생성을 위한 텍스트 설명입니다.
참고: 2000자를 초과할 수 없습니다

모델 이름
허용 값: viduq2, viduq1, viduq3-turbo, viduq3-pro

• viduq3-turbo: viduq3-pro보다 생성 속도가 빠름
• viduq3-pro: 고품질 오디오-비디오를 효율적으로 생성, 더 생동감 있고 입체적인 결과
• viduq2: 최신 모델
• viduq1: 선명한 화면, 부드러운 전환, 안정적인 카메라 움직임

비디오 길이, 기본값은 모델에 따라 다름:

• viduq3-pro, viduq3-turbo: 기본 5초, 범위 1–16
• viduq2: 기본 5초, 범위 1–10
• viduq1: 기본 5초, 5만 허용

랜덤 시드
생략하거나 0이면 임의 값 사용
수동 설정 시 해당 시드 사용

해상도, 기본값은 모델과 길이에 따라 다름:

• 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 모델 사용 시 이 매개변수는 적용되지 않음

패스스루 매개변수
처리하지 않으며 데이터 전송만 수행
참고: 최대 1048576자

비피크 모드, 기본 false, 허용:

• true: 비피크 모드로 비디오 생성
• false: 즉시 비디오 생성
  참고 1: 비피크 모드는 크레딧 소비가 적음, 요금제 참조
  참고 2: 비피크 작업은 48시간 내 생성, 미완료 작업은 자동 취소 및 크레딧 환불
  참고 3: 비피크 작업은 수동으로 취소 가능

워터마크 추가 여부

• 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는 콜백 서명 알고리즘으로 인증, 콜백 서명 문서 참조

첫 프레임 이미지
모델은 이 매개변수의 이미지를 첫 프레임으로 사용하여 비디오를 생성합니다.
참고 1: 이미지 Base64 또는 이미지 URL(접근 가능해야 함) 지원
참고 2: 이미지 1장만 허용
참고 3: 형식: png, jpeg, jpg, webp
참고 4: 화면 비율은 1:4 또는 4:1 미만
참고 5: 이미지 크기 50MB 이하
참고 6: HTTP POST body는 20MB 이하, 적절한 Content-Type 필요, 예:

data:image/png;base64,{base64_encode}

오디오-비디오 직접 출력 사용 여부, 기본 false, 허용:

• false: 직접 출력 없음(무음 비디오)
• true: 대사 및 배경음이 있는 비디오 출력
  참고 1: 이 매개변수가 true일 때만 voice_id 적용
  참고 2: model이 q3-pro 또는 q3-turbo일 때 기본값 true
  참고 3: 이 매개변수가 true일 때 비피크 모드 미지원

음색 ID
비디오 내 음색을 결정, 비어 있으면 시스템 추천. 목록: https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg

추천 프롬프트 사용 여부

• true: 시스템이 프롬프트 추천(수량=1) 후 해당 내용으로 생성
• false: 입력 prompt로 생성
  참고: 추천 프롬프트 사용 시 작업당 10 크레딧 추가 소비

Responses

성공

Content-Type

application/json

object