Skip to main content
POST
OpenAI video generations
이 엔드포인트를 사용하여 비동기 비디오 생성 작업을 생성합니다.
  • Authorization: Bearer {API_KEY}로 인증
  • 일반적인 흐름은 작업 생성, /v1/videos/{video_id} 폴링, /v1/videos/{video_id}/content 다운로드입니다.
  • 첫 번째 응답은 일반적으로 최종 자산 대신 작업 개체를 반환합니다.
  • 폴링은 서버 측에서 더 잘 처리됩니다.

인증

Authorization
string
header
필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

본문

multipart/form-data
model
string
필수

Video model name, for example sora-2.

예시:

"sora-2"

prompt
string
필수

Text prompt for the video.

예시:

"一只可爱的小猫在花园里玩耍"

size
enum<string>
기본값:720x1280

Video resolution.

사용 가능한 옵션:
720x1280,
1280x720
seconds
enum<string>

Video duration in seconds.

사용 가능한 옵션:
4,
8,
12
input_reference
file

Optional reference image file used as the first frame.

응답

Successful video task creation response

id
string
필수

Video task ID.

예시:

"video_123456789"

object
enum<string>
필수

Object type.

사용 가능한 옵션:
video
status
enum<string>
필수

Current task status.

사용 가능한 옵션:
pending,
in_progress,
completed,
failed
created_at
integer<int64>

Creation timestamp.

completed_at
integer<int64>

Completion timestamp.

model
string

Model used for generation.

progress
integer

Task progress percentage.

필수 범위: 0 <= x <= 100
expires_at
integer<int64>

Expiration timestamp for the generated asset.

seconds
string

Video duration in seconds.

size
enum<string>

Video resolution.

사용 가능한 옵션:
720x1280,
1280x720
remixed_from_video_id
string

Source video ID when the task comes from remix.

error
object