비디오 생성

플랫폼 통합 요청 구조로 공통 필드를 제출하고 metadata로 Vidu 전용 매개변수를 전달합니다.

POST/v1/video/generations

플랫폼 공통 비디오 작업 진입점으로 Vidu 작업을 생성합니다. 플랫폼은 공통 필드를 해당 Vidu 생성 기능에 매핑합니다.

Vidu 모델에는 viduq3-pro, viduq2, viduq1, vidu2.0, vidu1.5가 있습니다. 예시는 MODEL_ID를 사용하며 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

인증

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

생성할 비디오 내용을 설명합니다.

길이1 <= length

images?array<string>

참조 이미지 URL 목록입니다. 텍스트 기반 비디오 생성에서는 생략할 수 있습니다. 이미지 기반 비디오 생성에서는 일반적으로 한 장, 시작·종료 프레임 모드에서는 두 장을 전달하고 참조 이미지 모드에서는 여러 장을 전달할 수 있습니다.

image?string

일부 호환 클라이언트가 사용하는 단일 참조 이미지 URL입니다.

size?string

출력 해상도입니다. 예를 들어 720p, 1080p이며 Vidu의 resolution에 대응합니다.

duration?integer

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

허용 값

metadata?

Vidu 전용 확장 매개변수입니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "사이버펑크 스타일의 말이 달리고 뒤에는 네온 불빛이 깜박이는 미래 도시가 있습니다",
    "size": "720p",
    "duration": 5
  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

인증

요청 본문

응답 본문

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`