화면 모드
영상 만들기
영상은 만드는 데 몇 분이 걸리기 때문에 접수 → 상태 확인 → 결과 받기 세 단계로 진행합니다. 전체 파라미터는 영상 생성 레퍼런스에 있습니다.
POST /v1/videos 접수 → { id: "video_…", status: "queued" }
GET /v1/videos/{id} 확인 → status: queued → in_progress → completed | failed
GET /v1/videos/{id}/content 받기 → 결과 파일로 이동(302)1. 접수하기
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": 8,
"resolution": "720p",
"ratio": "9:16"
}'seconds: 4–15초 사이 정수resolution:"480p"또는"720p"ratio:"9:16","16:9","1:1"등- 참조 소재가 있으면
images(이미지 URL),videos(영상 URL),audios(오디오 URL)를 넣습니다.
접수가 되면 바로 작업 ID가 돌아옵니다.
json
{
"id": "video_…",
"object": "video",
"model": "seedance-2.5",
"status": "queued",
"seconds": "8",
"resolution": "720p",
"ratio": "9:16"
}접수할 때 금액이 먼저 빠집니다
영상 요금은 초당 단가 × 초이고, 접수 시점에 미리 차감됩니다. 생성에 실패하면 전액 자동 환불되고, 접수 후 3시간이 지나도 끝나지 않으면 실패로 처리하고 환불합니다. 과금 방식
2. 상태 확인하기
GET /v1/videos/{id}를 15–30초 간격으로 호출합니다. 보통 몇 분 안에 끝나지만, 몰리는 시간에는 더 걸릴 수 있습니다.
status | 뜻 |
|---|---|
queued | 접수됨, 순서를 기다리는 중 |
in_progress | 만드는 중 |
completed | 완료, url에 결과 주소가 있음 |
failed | 실패, error에 이유가 있음 (금액은 자동 환불) |
python
import os, time, requests
API = "https://api.lool.chat/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['LOOL_API_KEY']}"}
job = requests.post(f"{API}/videos", headers=HEADERS, json={
"model": "seedance-2.5",
"prompt": "새벽 바닷가를 걷는 노부부, 잔잔한 파도 소리",
"seconds": 8,
"resolution": "720p",
"ratio": "9:16",
}, timeout=60).json()
video_id = job["id"]
while True:
time.sleep(20) # 15–30초 간격
v = requests.get(f"{API}/videos/{video_id}", headers=HEADERS, timeout=30).json()
print(v["status"])
if v["status"] == "completed":
with open(f"{video_id}.mp4", "wb") as f:
f.write(requests.get(v["url"], timeout=300).content)
break
if v["status"] == "failed":
print("실패:", v.get("error"))
breakjs
const API = "https://api.lool.chat/v1";
const headers = {
Authorization: `Bearer ${process.env.LOOL_API_KEY}`,
"Content-Type": "application/json",
};
const job = await fetch(`${API}/videos`, {
method: "POST",
headers,
body: JSON.stringify({
model: "seedance-2.5",
prompt: "새벽 바닷가를 걷는 노부부, 잔잔한 파도 소리",
seconds: 8,
resolution: "720p",
ratio: "9:16",
}),
}).then((r) => r.json());
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
let v;
do {
await sleep(20_000); // 15–30초 간격
v = await fetch(`${API}/videos/${job.id}`, { headers }).then((r) => r.json());
console.log(v.status);
} while (v.status === "queued" || v.status === "in_progress");
if (v.status === "completed") console.log("결과:", v.url);
else console.error("실패:", v.error);3. 결과 받기
완료되면 응답의 url에서 바로 내려받거나, GET /v1/videos/{id}/content를 호출해 결과 파일로 이동(302)시킬 수 있습니다.
bash
curl -L -o result.mp4 \
-H "Authorization: Bearer $LOOL_API_KEY" \
https://api.lool.chat/v1/videos/video_…/contenturl은 https://api.lool.chat/files/{YYYYMMDD}/{작업ID}/{파일명} 형식의 고정 주소이고, 열 때마다 새 다운로드 링크로 이동(302)합니다.
주소 공유에 주의하세요
결과는 lool.chat 저장소에 보관되며 같은 주소로 언제든 다시 받을 수 있습니다. 주소를 아는 사람은 누구나 받을 수 있으니 외부 공유에 주의하세요.