동영상

동영상 생성 요청 제출

비동기 동영상 생성 작업을 제출합니다. 즉시 202와 작업 id(vjob_ 접두사)를 반환합니다. GET /api/v1/videos/{id}로 status가 completed가 될 때까지 폴링한 뒤 unsigned_urls로 다운로드하세요. 과금: 제출 시 duration × resolution으로 크레딧을 예약하고, 완료 시 실제 전달된 초 수로 정산합니다(폴링 응답의 usage.cost).

POST/api/v1/videos

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

model필수

string

동영상 생성 모델 ID(공급자 접두사 형식).

Example: "alibaba/wan2.7-t2v"

prompt필수

string

생성할 동영상을 설명하는 텍스트 프롬프트.

duration

integer

동영상 길이(초). 기본값 2. 모델마다 더 엄격한 범위가 있습니다 — 예: reference-to-video(r2v)는 2–10초. 범위를 벗어나면 크레딧 예약 전에 400을 반환합니다.

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

출력 화질 등급, 기본값 "720p". 지원 등급은 모델마다 다릅니다. 지원하지 않는 등급은 크레딧 예약 전에 400을 반환하며, 오류 메시지에 지원 등급 목록이 포함됩니다.

480p720p1080p

Example: "720p"

aspect_ratio

string

화면비. 일반적인 값: "16:9", "9:16", "1:1", "4:3", "3:4". 정확한 집합은 모델에 따라 다릅니다("21:9" 같은 와이드 비율을 받는 모델도 있음). 지원하지 않는 조합은 크레딧 예약 전에 400을 반환합니다. 입력 프레임을 받는 모드는 프레임에서 비율을 가져오며 이 필드를 무시합니다.

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

첫/마지막 키프레임 이미지(image-to-video, keyframe-to-video). URL 문자열 또는 객체 { type: "image", image_url: { url }, frame_type: "first" | "last" }를 받습니다.

input_references

object[] | string[]

참조 자산(reference-to-video): 참조 항목으로 생성을 유도합니다. 객체 형식 { type: "image", image_url: { url } } 권장(URL 문자열도 허용되며 이미지 참조로 처리). 이미지 참조가 가장 널리 지원됩니다. 오디오/비디오 참조 객체는 그대로 전달되며 지원 모델에서만 유효합니다 — 다른 모델은 이미지 참조만 사용합니다. r2v 모드가 있는 모델만 이 필드를 받습니다.

input_video

string | object

소스 동영상(동영상 편집 모델 전용, BazaarLink 확장 필드). URL 문자열, { video_url: { url } } 또는 { url }를 받습니다. 편집 모델이 아니면 무시됩니다. 편집은 소스 초 + 전달된 출력 초로 과금됩니다.

generate_audio

boolean

오디오도 함께 생성할지 여부. 오디오 지원 모델에서만 유효하며, 오디오 포함 초는 더 높은 초당 요율로 과금됩니다.

watermark

boolean

출력에 워터마크를 넣을지 여부. 기본값 false — 명시적으로 true를 전달하지 않는 한 BazaarLink가 기본 워터마크를 적극적으로 비활성화합니다.

seed

number

샘플링 시드. 재현성 보장은 모델마다 다릅니다.

callback_url

string

작업의 최종 상태에 호출되는 웹훅 URL — 폴링이 필요 없습니다. HTTPS만 허용되며, 크레딧이 예약되기 전에 SSRF 검사(사설/내부 주소 거부)를 거칩니다. 최종 상태 판정에서 승리한 요청에서만 정확히 한 번 발생합니다. 전송은 실패 시 재시도되며(2회, 2초/8초 백오프), 재시도를 모두 소진해도 과금이나 작업의 실제 상태에는 영향이 없습니다. v1에는 서명이 없습니다 — 콜백은 힌트로 취급하고, 조치를 취하기 전에 API 키로 GET /v1/videos/{id}를 호출해 상태와 금액을 확인하세요. ⚠️ 웹훅 페이로드의 unsigned_urls는 절대 URL이며, 폴링 엔드포인트가 반환하는 상대 경로와 다릅니다.

https:// only, ≤2048 chars

심층 가이드 →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

응답 예시

작업 접수됨(비동기). 반환된 polling_url(GET /api/v1/videos/{id})로 상태를 폴링하세요. 5초 이상 간격을 권장합니다.

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}