img_uuid를 저장한 뒤 폴링 또는 콜백을 사용하여 생성된 영상을 수신하세요.일관된 영상 피사체를 위한 Vidu Q3 터보 참조 API
독립적인 GoEnhance 오픈 API를 통해 Vidu Q3 터보 참조 API에 액세스하세요. 프롬프트와 함께 1~7개의 참조 이미지를 전송하고, 반환된
API 키 받기
유효한 참조-비디오 생성 요청 빌드
1~7개의 참조 이미지 제공
model: viduq3_turbo_reference, 필수 프롬프트, 그리고 1~7개의 공개 이미지 URL이 포함된 image_urls 배열을 사용하여 https://api.goenhance.ai/api/v1/videos/generations에 POST 요청을 보냅니다.
모든 비동기 작업 추적
1~16초의 재생 시간과 540p, 720p 또는 1080p 해상도를 선택하세요. 반환된 img_uuid를 저장한 다음 GET /api/v1/jobs/detail을 폴링하거나 custom_callback_url을 구성하세요.
프로덕션 작업을 제출하기 전에 참조 전용 계약을 검증하세요.
Vidu Q3 터보 참조 API 기능 및 매개변수
정확한 모델 ID
<code>model</code>을 <code>viduq3_turbo_reference</code>로 설정하세요. 밑줄을 정확하게 유지해야 합니다.
필수 프롬프트
<code>prompt</code>에 의도한 동작, 설정, 카메라 움직임 및 시각적 처리를 설명하세요.
참조 배열
<code>image_urls</code>를 통해 1~7개의 공개 이미지 URL을 제공하세요.
참조 전용 경로
<code>image_url</code> 또는 <code>image_end_url</code>을 보내지 마세요. 해당 모드에는 <code>viduq3_turbo</code>를 사용하세요.
재생 시간
1에서 16초 사이의 정수를 선택하세요. 문서화된 기본값은 5초입니다.
해상도
<code>540p</code>, <code>720p</code> 또는 <code>1080p</code>를 사용하세요. 문서화된 기본값은 <code>720p</code>입니다.
선택한 초당 요금에 요청한 재생 시간을 곱하여 총 비용을 산정합니다.
Vidu Q3 터보 참조 API 가격
540p
생성된 초당 1토큰, 문서화된 토큰당 $0.02 요율 기준 초당 $0.02에 해당합니다.
720p
생성된 초당 2.5토큰, 문서화된 토큰당 $0.02 요율 기준 초당 $0.05에 해당합니다.
1080p
생성된 초당 3.25토큰, 문서화된 토큰당 $0.02 요율 기준 초당 $0.065에 해당합니다.
6단계로 Vidu Q3 터보 참조 API 통합하기
1
1. API 키 생성
GoEnhance 키를 생성하고 Authorization 헤더에 베어러 토큰으로 전송합니다.
2
2. 참조 이미지 준비
승인된 1~7개의 참조 이미지를
image_urls에 제공할 수 있는 공개 URL에 호스팅합니다. 3
3. 페이로드 검증
정확한 모델 ID, 프롬프트, 재생 시간 및 문서화된 해상도 하나를 설정하고, 첫 프레임 전용 필드는 생략합니다.
4
4. 작업 제출
/api/v1/videos/generations에 POST 요청을 보내고 반환된 img_uuid를 유지합니다. 5
5. 상태 추적
GET /api/v1/jobs/detail을 폴링하거나 공개 HTTPS 콜백 URL을 제공합니다. 6
6. 완료 처리
성공 또는 실패 여부를 멱등하게 처리하고 다운스트림에서 사용하기 전에 반환된 비디오를 확인합니다.
승인된 시각적 입력이 생성된 장면을 안내하는 반복 가능한 파이프라인을 구축합니다.
참조 기반 비디오를 위한 개발자 사용 사례
캐릭터 연속성
승인된 여러 캐릭터 뷰를 사용하여 생성된 짧은 클립 전반에서 반복되는 피사체를 안내합니다.
제품 스토리텔링
검토 가능한 캠페인 컨셉을 위해 제품 참조 이미지와 장면 프롬프트를 제공합니다.
캠페인 변형
승인된 시각적 참조 세트를 재사용하면서 다양한 배치나 스토리 비트에 맞춰 프롬프트를 변경합니다.
사전 시각화
본격적인 제작에 앞서 캐릭터, 소품, 환경 참조 이미지를 모션 컨셉으로 전환합니다.
현지화된 크리에이티브
지역별 변형 전반에서 동일한 승인된 시각적 참조를 유지하면서 장면 프롬프트를 매개변수화합니다.
직렬화된 콘텐츠
독립적으로 제출된 비동기 작업 전반에서 반복되는 피사체와 아트 디렉션을 안내합니다.
일반적인 입력, 가격 책정, 작업 상태 및 ShengShu API 관련 질문에 대한 답변입니다.