상품 영상
제품 이미지와 명시적인 출력 길이로 Ecommerce Video 워크플로 작업을 만듭니다.
입력이 로컬 파일이면 로컬 입력을 업로드하고 반환된 data.url을 사용하세요. data.id를 저장하고, 작업을 폴링하며, 오류 및 재시도 정책을 따르세요.
인증
AuthorizationBearer
API 키를 Authorization: Bearer <BEATAPI_API_KEY>로 보내세요.
헤더
Idempotency-Key
재시도용 키입니다(선택 사항). 같은 요청 본문에 같은 키를 다시 쓰면 접수된 작업을 반환하고, 다른 본문에 쓰면 409 idempotency_conflict를 반환합니다.
요청
This endpoint expects an object.
images
대표 제품 또는 장면 이미지를 먼저 넣고, 그 뒤에 공개 HTTPS PNG, JPEG, WebP 제품·라이프스타일 이미지를 최대 6장 추가합니다. 로컬 파일은 POST /v1/files로 업로드하고 반환된 data.url을 사용하세요.
duration
필수 목표 출력 길이(초)이며 USD 계산의 기준입니다. 허용 범위는 10-60초입니다.
prompt
크리에이티브 방향, 대상 고객, 제품 장점, 혜택, 톤, 장면 또는 행동 유도 문구입니다(선택 사항). 최대 2000자.
aspect_ratio
목표 출력 배치입니다. 가로는 16:9, 세로 소셜은 9:16, 정사각형은 1:1을 사용하세요. 안정적인 레이아웃을 위해 명시적으로 설정하세요.
허용된 값:
language
대사와 내레이션 언어입니다. 영어는 en, 중국어는 zh를 사용하세요. 프롬프트에 여러 언어가 섞여 있으면 명시적으로 설정하세요.
허용된 값:
응답
작업 접수됨
data
접수되었거나 현재의 BeatAPI 작업 상태입니다.
오류
400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error