Skip to main content
POST

인증

string
required
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 가져오기:API 키 관리 페이지를 방문하여 API 키를 가져오세요요청 헤더에 추가:

요청 파라미터

string
default:"sora-2"
required
비디오 생성 모델 이름예시: "sora-2"
string
required
비디오 생성용 텍스트 설명
integer
비디오 길이(초)예시: 5
string
비디오 화면 비율지원 형식:
  • 16:9 (가로)
  • 9:16 (세로)
array<url>
이미지-비디오 생성을 위한 참조 이미지 URL 배열공개적으로 접근 가능한 이미지 URL(http:// 또는 https://)을 지원합니다예시: ["https://example.com/image.jpg"]제한사항:
  • 최대 파일 크기: 10MB
  • 지원 형식: .jpeg, .jpg, .png, .webp

응답

integer
작업 생성 타임스탬프
string
고유 작업 식별자
string
실제로 사용된 모델 이름
string
객체 유형, video.generation.task로 고정
integer
작업 완료 진행률(0–100)
string
작업 상태가능한 값:
  • pending - 처리 대기
  • processing - 처리 중
  • completed - 완료
  • failed - 실패
object
작업 세부 정보
string
출력 유형, video로 고정
object
과금 정보