화면 모드
영상 생성
영상은 비동기로 만듭니다. 접수하면 작업 ID를 바로 돌려주고, 그 ID로 상태를 조회해 완료되면 결과를 받습니다. 생성에는 보통 몇 분이 걸립니다.
영상 접수
POST/v1/videos
요청 본문
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
model | string | 선택 | seedance-2.5 (현재 제공 모델) |
prompt | string | 필수 | 만들 영상 설명 |
seconds | integer | 선택 | 영상 길이, 4–15 사이 정수. 기본값 5 |
resolution | string | 선택 | "480p" 또는 "720p". 기본값 "720p" |
ratio | string | 선택 | "9:16", "16:9", "1:1" 등 |
images | string | string[] | 선택 | 참조 이미지 URL |
videos | string | string[] | 선택 | 참조 영상 URL |
audios | string | string[] | 선택 | 참조 오디오 URL |
seconds는 8과 "8" 모두 받습니다. 참조 소재는 lool.chat 서버가 내려받을 수 있는 공개 URL이어야 합니다.
과금
- 요금 = 초당 단가 ×
seconds. 단가는 해상도에 따라 다를 수 있습니다. - 접수할 때 먼저 차감합니다. 잔액이 부족하면
402로 거절하고 접수하지 않습니다. - 생성에 실패하면 전액 자동 환불합니다.
- 접수 후 3시간이 지나도 끝나지 않으면 실패로 처리하고 환불합니다.
요금표는 요금·결제를 보세요.
응답 200
json
{
"id": "video_…",
"object": "video",
"model": "seedance-2.5",
"status": "queued",
"progress": 0,
"created_at": 1763337600,
"seconds": "8",
"resolution": "720p",
"ratio": "9:16"
}예시
bash
curl https://api.lool.chat/v1/videos \
-H "Authorization: Bearer $LOOL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "골목 끝 작은 빵집, 문을 여는 제빵사, 따뜻한 아침 빛",
"seconds": 10,
"resolution": "720p",
"ratio": "16:9",
"images": ["https://example.com/baker.png"]
}'python
import os, requests
r = requests.post(
"https://api.lool.chat/v1/videos",
headers={"Authorization": f"Bearer {os.environ['LOOL_API_KEY']}"},
json={
"model": "seedance-2.5",
"prompt": "골목 끝 작은 빵집, 문을 여는 제빵사, 따뜻한 아침 빛",
"seconds": 10,
"resolution": "720p",
"ratio": "16:9",
"images": ["https://example.com/baker.png"],
},
timeout=60,
)
r.raise_for_status()
print(r.json()["id"])js
const r = await fetch("https://api.lool.chat/v1/videos", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.LOOL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedance-2.5",
prompt: "골목 끝 작은 빵집, 문을 여는 제빵사, 따뜻한 아침 빛",
seconds: 10,
resolution: "720p",
ratio: "16:9",
images: ["https://example.com/baker.png"],
}),
});
const job = await r.json();
console.log(job.id);상태 조회
GET/v1/videos/{id}
접수 때 받은 id로 상태를 조회합니다. 15–30초 간격으로 호출하세요. 더 자주 호출해도 빨리 끝나지 않습니다.
status | 뜻 |
|---|---|
queued | 접수됨, 대기 중 |
in_progress | 생성 중 |
completed | 완료. url에 결과 주소 |
failed | 실패. error에 이유, 금액은 자동 환불 |
응답 — 완료
json
{
"id": "video_…",
"object": "video",
"model": "seedance-2.5",
"status": "completed",
"progress": 100,
"created_at": 1763337600,
"completed_at": 1763337900,
"seconds": "10",
"resolution": "720p",
"ratio": "16:9",
"url": "https://api.lool.chat/files/20261117/video_…/….mp4"
}url은 https://api.lool.chat/files/{YYYYMMDD}/{작업ID}/{파일명} 형식의 고정 주소이며, 열 때마다 새 다운로드 링크로 302 이동합니다. 결과는 lool.chat 저장소에 보관되며 같은 주소로 언제든 다시 받을 수 있습니다. 주소를 아는 사람은 누구나 받을 수 있으니 외부 공유에 주의하세요.
응답 — 실패
json
{
"id": "video_…",
"object": "video",
"status": "failed",
"error": {
"message": "video generation failed",
"code": "video_generation_failed"
}
}폴링 예시
python
import os, time, requests
API = "https://api.lool.chat/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['LOOL_API_KEY']}"}
def wait_for_video(video_id: str, interval: int = 20) -> dict:
while True:
v = requests.get(f"{API}/videos/{video_id}", headers=HEADERS, timeout=30).json()
if v.get("status") in ("completed", "failed"):
return v
time.sleep(interval) # 15–30초 권장
v = wait_for_video("video_…")
print(v["status"], v.get("url") or v.get("error"))결과 파일 받기
GET/v1/videos/{id}/content
완료된 영상의 파일 주소로 302 리다이렉트합니다. 리다이렉트를 따라가도록 설정하세요(curl은 -L).
bash
curl -L -o video.mp4 \
-H "Authorization: Bearer $LOOL_API_KEY" \
https://api.lool.chat/v1/videos/video_…/content| HTTP | code | 상황 |
|---|---|---|
| 302 | — | 결과 파일로 이동 |
| 404 | video_not_found | 없는 ID이거나 내 작업이 아님 |
| 409 | video_not_ready | 아직 완료되지 않음 |
오류
| HTTP | code | 상황 |
|---|---|---|
| 400 | invalid_request | seconds가 4–15 밖, resolution이 480p·720p가 아님, prompt 누락, JSON 형식 오류 |
| 401 | — | API 키가 없거나 잘못됨 |
| 402 | insufficient_user_quota | 잔액 부족 |
| 404 | video_not_found | 작업을 찾을 수 없음 |
| 503 | model_not_available | 요청한 모델을 지금 쓸 수 없음 |
전체 목록은 오류 코드를 보세요.