참조 이미지 기반 비디오 생성

Vidu 네이티브 API로 참조 이미지 기반 비디오 작업을 생성합니다.

하나 이상의 참조 이미지로 비디오의 대상 또는 시각적 특징을 제어합니다.

POST/vidu/ent/v2/reference2video

하나 이상의 참조 이미지로 비디오의 대상 또는 시각적 특징을 제어합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Vidu 네이티브 참조 이미지 기반 비디오 요청입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

Vidu 모델 ID입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt?string

생성할 비디오 내용과 참조 이미지의 대상 또는 시각적 특징을 활용하는 방법을 설명합니다.

images*array<string>

하나 이상의 참조 이미지 URL입니다.

항목1 <= items

duration?integer

비디오 길이이며 단위는 초입니다.

허용 값

resolution?string

출력 해상도입니다.

허용 값

"720p"
"1080p"

aspect_ratio?string

출력 화면 비율입니다.

허용 값

"16:9"
"9:16"
"1:1"

movement_amplitude?string

움직임 강도입니다. 예를 들어 low, medium, high입니다.

audio?boolean

오디오 생성 여부입니다.

audio_type?string

오디오 유형입니다.

bgm?boolean

배경 음악 생성 여부입니다.

style?string

생성 스타일입니다.

watermark?boolean

결과에 워터마크 포함 여부입니다.

off_peak?boolean

비혼잡 시간대 모드 사용 여부입니다.

callback_url?string

작업 상태 callback 주소입니다.

형식uri

응답 본문

`application/json`

curl -X POST "https://example.com/vidu/ent/v2/reference2video" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "참조 이미지 속 인물의 모습을 유지하면서 인물이 도시 거리를 달리게 해 주세요",
    "images": [
      "https://example.com/character-front.jpg",
      "https://example.com/character-side.jpg"
    ],
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

응답 예시가 없습니다

비디오 작업이 제출되었습니다. 응답은 Vidu 네이티브 작업 구조를 사용합니다.

참조 이미지 기반 비디오 생성

인증

요청 본문

응답 본문

200

400application/json

401application/json

`application/json`

`application/json`