메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
curl --request POST \
  --url 'https://api.elkapi.com/v1/videos' \
  --header 'Authorization: Bearer <token>' \
  --form 'model=sora-2' \
  --form 'prompt=햇살이 비치는 정원에서 달리는 작은 고양이, 영화적인 느낌, 높은 디테일' \
  --form 'image=https://example.com/image.png' \
  --form 'duration=5' \
  --form 'width=1280' \
  --form 'height=720' \
  --form 'fps=30' \
  --form 'seed=12345' \
  --form 'n=1' \
  --form 'response_format=json' \
  --form 'user=user-1234' \
  --form 'metadata=[object Object]'
{
  "id": "id",
  "object": "object",
  "model": "sora-2",
  "status": "status",
  "progress": 1,
  "created_at": 1,
  "seconds": "seconds",
  "completed_at": 1,
  "expires_at": 1,
  "size": "1024x1024",
  "error": {
    "message": "message",
    "code": "code"
  },
  "metadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url 'https://api.elkapi.com/v1/videos' \
  --header 'Authorization: Bearer <token>' \
  --form 'model=sora-2' \
  --form 'prompt=햇살이 비치는 정원에서 달리는 작은 고양이, 영화적인 느낌, 높은 디테일' \
  --form 'image=https://example.com/image.png' \
  --form 'duration=5' \
  --form 'width=1280' \
  --form 'height=720' \
  --form 'fps=30' \
  --form 'seed=12345' \
  --form 'n=1' \
  --form 'response_format=json' \
  --form 'user=user-1234' \
  --form 'metadata=[object Object]'
{
  "id": "id",
  "object": "object",
  "model": "sora-2",
  "status": "status",
  "progress": 1,
  "created_at": 1,
  "seconds": "seconds",
  "completed_at": 1,
  "expires_at": 1,
  "size": "1024x1024",
  "error": {
    "message": "message",
    "code": "code"
  },
  "metadata": {}
}

Authorizations

Authorization
string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다.요청 헤더에 추가하세요:
Authorization: Bearer YOUR_API_KEY

Body

model
string
기본값:"sora-2"
모델/스타일 ID예시: sora-2
prompt
string
텍스트 프롬프트예시: 우주비행사가 일어나 걸어갔습니다
image
string
이미지 입력(URL 또는 Base64)예시: https://example.com/image.jpg
duration
number
비디오 길이(초)예시: 5
width
integer
비디오 너비예시: 1280
height
integer
비디오 높이예시: 720
fps
integer
비디오 프레임레이트예시: 30
seed
integer
랜덤 시드예시: 20231234
n
integer
생성할 비디오 수예시: 1
response_format
string
응답 형식예시: url
user
string
사용자 식별자예시: user-1234
metadata
object
확장 파라미터(예: negative_prompt, style, quality_level 등)

Response

id
string
비디오 ID
object
string
객체 유형
model
string
기본값:"sora-2"
사용된 모델예시: sora-2
status
string
작업 상태
progress
integer
진행률
created_at
integer
생성 타임스탬프
seconds
string
비디오 길이
completed_at
integer
완료 타임스탬프
expires_at
integer
만료 타임스탬프
size
string
비디오 크기
error
object
OpenAI 비디오 오류 정보
error.message
string
오류 메시지
error.code
string
오류 코드
metadata
object
추가 메타데이터