img_uuid로 폴링하거나 상태 콜백을 받으세요.일관된 영상을 위한 Vidu Q3 Reference API
독립적인 GoEnhance 오픈 API를 통해 Vidu Q3 참조에 액세스하세요. 프롬프트와 함께 1~7개의 참조 이미지를 제공하고 비동기식 비디오 작업을 제출한 다음, 반환된
API 키 받기
Vidu Q3 Reference API 요청 빌드
일관성을 위해 구축된 참조 이미지 입력
model: viduq3_reference, 필수 프롬프트, 그리고 1~7개의 공개 참조 이미지가 포함된 image_urls를 사용하여 https://api.goenhance.ai/api/v1/videos/generations에 POST 요청을 보내세요.
검증된 요청 및 비동기식 결과
제출 전 이미지 형식, 크기, 가로세로 비율, 지속 시간, 해상도 및 출력 비율을 검증하세요. img_uuid를 유지한 다음 GET /api/v1/jobs/detail을 폴링하거나 공개 HTTPS 콜백을 사용하세요.
작업을 제출하기 전에 문서화된 참조-영상 요청 스키마를 확인하세요.
Vidu Q3 Reference API 기능 및 제한 사항
모델 및 프롬프트
<code>model</code>을 <code>viduq3_reference</code>로 설정하고 의도한 영상을 설명하는 필수 텍스트 프롬프트를 제공하세요.
참조 이미지
<code>image_urls</code>에 1~7개의 URL을 전송하세요. 각 이미지는 PNG, JPEG, JPG 또는 WebP 형식이어야 하며, 최소 128×128 픽셀, 최대 50MB, 가로세로 비율은 1:4에서 4:1 사이여야 합니다.
전용 입력 모드
이 경로는 <code>image_url</code>이나 <code>image_end_url</code>이 아닌 <code>image_urls</code>를 허용합니다. 텍스트 전용, 첫 프레임 또는 시작-끝 프레임 생성에는 <code>viduq3_pro</code>를 사용하세요.
지속 시간
3에서 16초 사이의 정수를 선택하세요. 문서화된 기본값은 5초입니다.
해상도
<code>540p</code>, <code>720p</code> 또는 <code>1080p</code>를 선택하세요. 문서화된 기본값은 <code>720p</code>입니다.
출력 비율
<code>ratio</code>를 <code>16:9</code>, <code>9:16</code> 또는 <code>1:1</code>로 설정하세요. 문서화된 기본값은 <code>16:9</code>입니다. <code>aspect_ratio</code>는 호환 가능한 별칭으로 허용됩니다.
선택한 초당 요금에 요청한 재생 시간을 곱하여 비용을 산정합니다.
Vidu Q3 Reference API 가격
540p
생성 초당 1.75 토큰, 문서화된 토큰당 $0.02 요율 기준 초당 $0.035에 해당합니다.
720p
생성 초당 3 토큰, 문서화된 토큰당 $0.02 요율 기준 초당 $0.06에 해당합니다.
1080p
생성 초당 3.75 토큰, 문서화된 토큰당 $0.02 요율 기준 초당 $0.075에 해당합니다.
6단계로 Vidu Q3 Reference 통합하기
1
1. API 키 생성
GoEnhance 키를 생성하고 Authorization 헤더에 베어러 토큰으로 전송하세요.
2
2. 참조 이미지 준비
1~7개의 규격에 맞는 참조 이미지를 공개 URL에 호스팅하고 프롬프트에서 유지할 시각적 세부 정보를 결정하세요.
3
3. 요청 검증
viduq3_reference, 3~16초의 재생 시간, 지원되는 해상도 및 지원되는 비율을 설정하세요. 4
4. 작업 제출
/api/v1/videos/generations에 POST 요청을 보내고 반환된 img_uuid를 저장하세요. 5
5. 상태 추적
GET /api/v1/jobs/detail을 폴링하거나 공개 HTTPS custom_callback_url을 구성하세요. 6
6. 완료 처리
성공 및 실패 상태를 멱등성 있게 처리한 다음, 후속 작업에 사용하기 전에 생성된 에셋을 확인하세요.
명시적 입력과 최종 작업 상태를 중심으로 반복 가능한 참조-비디오 워크플로우를 구축하세요.
Vidu Q3 Reference API의 개발자 사용 사례
캐릭터 중심 캠페인 클립
승인된 가상 캐릭터나 인물 참조를 짧은 캠페인 비디오 컨셉에 적용하세요.
제품 아이덴티티 시퀀스
승인된 여러 제품 뷰를 모션 중심의 창의적 탐색을 위한 시각적 참조로 사용하세요.
스토리 연속성
스토리보드 및 프리비주얼 워크플로우를 위해 별도의 샷을 생성할 때 반복되는 피사체를 참조하세요.
현지화된 크리에이티브 변형
지역별 캠페인 컨셉에 맞춰 프롬프트를 조정하면서 승인된 시각적 참조를 재사용하세요.
스타일이 일관된 소셜 에셋
제어된 시각적 참조 세트와 출력 비율을 중심으로 숏폼 비디오 파이프라인을 구축하세요.
크리에이티브 프로토타이핑
더 넓은 제작 워크플로우로 넘어가기 전에 참조 조합, 프롬프트, 재생 시간 및 해상도를 테스트하세요.
가격, 참조 입력, 비동기 작업 및 ShengShu API에 관한 일반적인 질문에 대한 답변입니다.