비디오 생성

통합 JSON 구조로 요청을 제출하고 작업 ID를 반환합니다. 모델 전용 매개변수는 공통 필드 또는 metadata로 전달합니다.

POST/v1/video/generations

텍스트 프롬프트와 선택적 이미지로 비동기 비디오 생성 작업을 생성합니다. API는 이후 작업 상태와 결과를 조회하는 데 사용하는 task_id를 반환합니다.

모델마다 지원하는 입력 형식과 공급업체 확장 매개변수가 다를 수 있습니다. 현재 API 키에 표시되며 비디오 생성을 지원하는 모델을 선택하고 해당 모델이 지원하는 매개변수만 전달하세요.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

JSON으로 모델, 프롬프트 및 선택적 비디오 생성 매개변수를 제출합니다.

TypeScript 타입 정의

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

model*string

사용할 비디오 모델 ID입니다. 현재 API 키에 표시되며 비디오 생성을 지원하는 모델을 선택하세요.

길이1 <= length

prompt*string

생성할 비디오 내용을 설명합니다. 대상, 동작, 장면, 카메라 움직임 및 스타일을 명확히 지정하는 것이 좋습니다.

길이1 <= length

duration?number

비디오 길이이며 단위는 초입니다. 선택 가능한 범위는 선택한 모델에 따라 다릅니다.

fps?integer

출력 비디오의 프레임 레이트입니다. 지원 여부와 선택 가능한 범위는 선택한 모델에 따라 다릅니다.

height?integer

출력 비디오 높이입니다. width와 함께 사용할 수 있으며 지원 여부는 선택한 모델에 따라 다릅니다.

width?integer

출력 비디오 너비입니다. height와 함께 사용할 수 있으며 지원 여부는 선택한 모델에 따라 다릅니다.

size?string

출력 비디오 크기이며 일반적으로 너비x높이 형식을 사용합니다. 실제 선택 가능한 크기는 선택한 모델에 따라 다릅니다.

image?string

이미지 기반 비디오 생성에 사용하는 이미지 입력입니다. 이미지 URL 또는 Base64 데이터일 수 있으며 구체적인 입력 형식은 선택한 모델에 따라 다릅니다.

metadata?

공급업체 또는 모델 전용 확장 매개변수입니다. 예를 들어 negative_prompt, style, quality_level, 시작·종료 프레임 및 callback 주소가 있습니다. 모든 비디오 모델이 이러한 필드를 지원하는 것은 아닙니다.

n?integer

생성할 비디오 수입니다. 지원 여부와 선택 가능한 범위는 선택한 모델에 따라 다릅니다.

response_format?string

원하는 응답 형식입니다. 선택 가능한 값은 선택한 모델과 채널에 따라 다릅니다.

seed?integer

생성의 무작위성을 제어하는 Seed입니다. 지원 여부는 선택한 모델에 따라 다릅니다.

user?string

호출자가 제공하는 최종 사용자 식별자입니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "우주복을 입은 우주비행사가 달 위를 걷고 있습니다. 고품질, 영화 같은 스타일",
    "size": "1920x1080",
    "image": "https://example.com/input.jpg",
    "duration": 5,
    "metadata": {
      "seed": 20231234,
      "negative_prompt": "흐릿함",
      "image_tail": "https://example.com/end-frame.png"
    }
  }'

{
  "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`