Vidu Image Q2 · API 레퍼런스
Vidu Image Q2로 텍스트나 참조 이미지에서 이미지를 생성하고 작업 상태를 확인한 뒤 결과를 다운로드하세요.
POST /v1/wand/vidu-image/generation로 작업을 만들고 GET /v1/wand/vidu-image/tasks/{task_id}로 쿼리합니다. 두 요청 모두와 함께 Authorization: Bearer 헤더에 APIMaster API 키를 보냅니다. POST 요청 본문은 JSON 형식입니다.
| 필드 | 유형 | 설명 |
|---|---|---|
model |
string | 필수입니다. vidu-image-q2를 사용하십시오. |
prompt |
string | 필수입니다. 최대 2,000자입니다. 텍스트만으로 이미지를 생성하려면 참조 이미지를 생략하세요 (text-to-image). |
images |
string[] | 선택 사항입니다. PNG, JPEG/JPG 또는 WebP 형식의 공개 URL이나 데이터 URI를 최대 7개 지정할 수 있습니다. 각 이미지는 128 × 128픽셀 이상이며 가로세로 비율은 1:4~4:1, 파일 크기는 최대 50 MB입니다. 전체 요청 본문은 최대 20 MB입니다. |
aspect_ratio |
string | 기본적으로 16:9입니다. 옵션에는 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 및 auto가 있습니다. auto 설정은 첫 번째 참조 이미지를 따릅니다. |
resolution |
string | 기본적으로 1080p입니다. 또한 2K 및 4K를 지원합니다. 대소문자를 구분합니다. |
seed |
integer | 무작위 시드를 사용하려면 필드를 생략하거나 0으로 설정하세요. |
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'
반환된 task_id와 같은 계정을 사용해 3–5초마다 상태를 조회하세요. 가능한 상태는 created, queueing, processing, success 및 failed입니다. 성공시, 12 시간 내에 creations[].url에서 파일을 다운로드합니다. request_id를 사용하여 유효하지 않은 이미지, 콘텐츠 검토, 불충분한 크레딧, 요청 빈도 제한 또는 누락된 작업과 같은 오류를 추적합니다.
상태를 조회해도 생성이 다시 실행되거나 요금이 다시 청구되지 않습니다. callback_url는 지원되지 않습니다. 손실된 제출물을 복구하려면 8–128 표시 ASCII 문자의 안정적인 Idempotency-Key를 보내고 원래 요청 복구 가이드를 따르십시오. 같은 키와 매개변수를 사용하면 HTTP 202와 복구 영수증이 반환됩니다. 같은 키에 다른 매개변수를 사용하면 HTTP 409가 반환됩니다.
tokenhub_usage.total_tokens는 해상도와 얼마나 많은 참조가 사용되었는지에 따라 청구 가능한 사용량을 보고합니다. 자세히 보기 Vidu Image Q2 모델 카드 현재에 대하여 For the Current APIMaster 가격.
