메인 콘텐츠로 건너뛰기

​
개요

비디오 생성은 비동기 방식으로 이루어집니다. 요청을 제출하고 작업 ID(task_id)를 받은 후, 결과를 확인하기 위해 폴링(poll)을 수행합니다.

​
요청 본문

​
model
string
기본값:"sora-2"
비디오 모델 ID입니다. 11개 제공업체의 80개 이상의 모델 전체 목록은 Video Generation Guide를 참조하세요.
​
prompt
string
필수
생성할 비디오에 대한 텍스트 설명입니다.
​
image_url
string
이미지 투 비디오(I2V) 생성을 위한 시작 이미지의 URL입니다.
​
image
string
데이터 URL 접두사가 포함된 Base64 인코딩 이미지입니다(예: data:image/jpeg;base64,...). I2V 생성을 위한 image_url의 대안으로 사용됩니다.
​
duration
integer
비디오 재생 시간(초)입니다(모델에 따라 다름).
​
aspect_ratio
string
종횡비(예: 16:9, 9:16, 1:1).
​
resolution
string
비디오 해상도(예: 1080p, 720p).
​
fps
integer
초당 프레임 수(1-120).
​
negative_prompt
string
비디오 생성 시 제외할 내용입니다.
​
seed
integer
재현 가능한 생성을 위한 랜덤 시드(seed) 값입니다.
​
cfg_scale
number
Classifier-free guidance 스케일(0-20)입니다.
​
motion_strength
number
모션 강도(0-1)입니다.
​
start_image
string
시작 프레임 이미지의 URL입니다.
​
end_image
string
종료 프레임 이미지의 URL입니다.
​
user
string
최종 사용자를 위한 고유 식별자입니다.

​
응답

​
task_id
string
폴링을 위한 고유 작업 식별자입니다.
​
status
string
초기 상태: pending.
​
model
string
사용된 모델입니다.
curl -X POST "https://api.lemondata.cc/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "duration": 5
  }'

{
  "task_id": "video_abc123",
  "status": "pending",
  "model": "sora-2",
  "created_at": 1706000000
}

​
이미지 투 비디오 (Image to Video)

response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "wan2.6-i2v",
        "prompt": "The person starts walking forward",
        "image_url": "https://example.com/image.jpg"
    }
)

​
키프레임 제어

start_image와 end_image를 사용하여 첫 번째 프레임과 마지막 프레임을 제어할 수 있습니다(Seedance 2.0에서 지원): 
response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "seedance-2-0",
        "prompt": "Smooth transition from day to night",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5
    }
)

​
사용 가능한 모델

모델 목록은 수시로 업데이트됩니다. 최신 사용 가능 모델 및 가격 정보는 Models page를 방문하여 확인하세요.
기능 비교 및 사용 예시가 포함된 전체 가이드는 Video Generation Guide를 참조하세요.

​
Sora (OpenAI)

모델기능
sora-2T2V (기본값)
sora-2-proT2V, 고화질
sora-2-charactersT2V, 캐릭터 중심

​
Kling (Kuaishou)

모델기능
kling-v2.6-proT2V, 최신 세대
kling-v2.6-stdT2V, 빠름
kling-v2.1-masterT2V, I2V, 마스터 품질
kling-v2.1-proT2V, I2V
kling-videoT2V, I2V
kling-video-extend비디오 확장
kling-video-o1-proT2V, O1 추론
kling-effects시각 효과

​
Veo (Google)

모델기능
veo3.1T2V
veo3.1-proT2V, 전문가용
veo3.1-4kT2V, 4K 출력
veo3.1-fastT2V, 빠름
veo3T2V, 이전 세대

​
Seedance (ByteDance)

모델기능
seedance-2-0T2V, I2V, 키프레임, 확장, 편집
seedance-1-5-proT2V, I2V
seedance-1-0-proT2V, I2V
seedance-1-0-lite-t2vT2V, 경량
seedance-1-0-lite-i2vI2V, 경량

​
기타 제공업체

모델제공업체기능
hailuo-2.3MiniMaxT2V, I2V
hailuo-2.3-proMiniMaxT2V, I2V, 고화질
wan-2.6AlibabaT2V
wan2.6-i2vAlibabaI2V
runwayml-gen4-turbo-5RunwayT2V, I2V (5초)
runwayml-gen4-turbo-10RunwayT2V, I2V (10초)
luma-video-apiLumaT2V
luma-video-extend-apiLuma비디오 확장
viduq3-proShengshuT2V, I2V
viduq2-proShengshuT2V, I2V
grok-video-3xAIT2V
higgsfield-turboHiggsfieldT2V