비디오 생성

텍스트 프롬프트와 선택적 참조 이미지로 비동기 작업을 생성하고 상태 조회 및 결과 다운로드에 사용하는 Video ID를 반환합니다.

POST/v1/videos

텍스트 프롬프트와 선택적 참조 이미지로 비동기 비디오 생성 작업을 생성합니다. API는 OpenAI Videos 호환 Multipart 요청을 수신하고 작업 상태 조회에 사용할 수 있는 Video ID를 반환합니다.

비디오 모델마다 지원하는 길이, 크기, 참조 이미지 및 확장 매개변수가 다를 수 있습니다. 현재 API 키에 표시되며 비디오 생성을 지원하는 모델 ID를 선택하세요.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

multipart/form-data

Multipart로 프롬프트, 모델 및 선택적 참조 이미지를 제출합니다. 클라이언트에서는 요청 라이브러리가 Content-Type의 boundary를 자동 생성하도록 해야 합니다.

TypeScript 타입 정의

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

prompt*string

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

길이1 <= length

model?string

사용할 비디오 모델 ID입니다. 현재 API 키에 표시되며 비디오 생성을 지원하는 모델을 선택하세요. 모델마다 지원하는 입력 방식과 확장 매개변수가 다를 수 있습니다.

길이1 <= length

seconds?string

비디오 길이이며 단위는 초이고 기본값은 4입니다. 실제 선택 가능한 길이는 선택한 모델에 따라 다릅니다.

기본값"4"

size?string

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

기본값"720x1280"

input_reference?file

이미지 기반 비디오 생성 시 업로드하는 참조 이미지입니다. 일부 호환 모델은 직접 파일 업로드를 지원하지 않으므로 metadata.img_url로 이미지 URL을 전달해야 합니다.

형식binary

metadata?string

공급업체 또는 모델 전용 확장 매개변수이며 JSON 문자열로 제출해야 합니다. 이 객체의 필드를 모든 비디오 모델이 지원하는 공통 매개변수로 간주하지 마세요.

Wan 계열 확장 키에는 img_url, first_frame_url, last_frame_url, watermark, prompt_extend, audio, seed, resolution이 있습니다. 이미지 URL은 이미지 기반 비디오 생성에, 시작·종료 프레임 URL은 키 프레임 비디오에 사용됩니다. audio는 오디오 생성을 지원하는 모델에만 적용됩니다.

해상도 옵션에는 480P(832x480, 480x832, 624x624), 720P(1280x720, 720x1280, 960x960, 1088x832, 832x1088), 1080P(1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632)가 있습니다. 실제 지원 범위는 선택한 모델을 기준으로 합니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/videos" \
  -F prompt="우주복을 입은 우주비행사가 달 위를 걷고 있습니다. 고품질, 영화 같은 스타일" \
  -F model="MODEL_ID" \
  -F seconds="4" \
  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

인증

요청 본문

응답 본문

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`