화면 모드
문제 해결
401 키 오류
API 키를 확인하지 못했다는 뜻입니다.
- 헤더가
Authorization: Bearer 키형식인지 확인하세요.Bearer와 키 사이에 공백 한 칸이 있어야 합니다. - 키를 복사할 때 앞뒤 공백이나 줄바꿈이 들어가지 않았는지 확인하세요.
- 콘솔 토큰에서 그 키가 삭제되지 않았는지, 만료 시간이 지나지 않았는지 확인하세요.
- 요청 주소가
https://api.lool.chat/v1인지 확인하세요. 웹 콘솔 주소(https://lool.chat)로 보내면 안 됩니다. - MCP 연결이라면 API 키가 아니라 내 정보의 액세스 토큰을 써야 합니다. MCP 연결 개요
402 잔액 부족
code: "insufficient_user_quota" — 계정 잔액이 요청 금액보다 적습니다.
- 콘솔 충전에서 잔액을 채운 뒤 다시 요청하세요.
- 잔액은 충분한데 계속 거절된다면, 그 API 키에 건 한도를 다 썼는지 토큰 목록의 남은 한도를 확인하세요.
- 영상은 접수할 때 전체 금액을 먼저 차감하므로,
seconds가 길수록 필요한 잔액도 큽니다.
400 검증 오류
요청 값이 규칙에 맞지 않습니다. error.message에 이유가 영어로 적혀 있습니다.
| 메시지 예 | 고치는 방법 |
|---|---|
seconds must be an integer between 4 and 15 | 영상 seconds를 4–15 정수로 |
resolution must be one of 480p, 720p | 영상 resolution을 "480p" 또는 "720p"로 |
prompt is required | prompt를 채워서 |
invalid JSON body: … | JSON 문법(따옴표, 쉼표)과 Content-Type: application/json 헤더 확인 |
결과 주소를 잃어버렸을 때
결과는 lool.chat 저장소에 보관되며, 같은 주소(https://api.lool.chat/files/…)로 언제든 다시 받을 수 있습니다.
- 영상: 작업 ID(
video_…)로GET /v1/videos/{id}를 다시 호출하면url이 다시 옵니다.GET /v1/videos/{id}/content로 바로 받을 수도 있습니다. - 주소를 열었는데 파일 대신 다른 응답이 온다면, 내려받는 프로그램이 302 리다이렉트를 따라가는지 확인하세요(curl은
-L). - 주소를 아는 사람은 누구나 받을 수 있으니 외부 공유에 주의하세요.
영상이 오래 걸리거나 실패했어요
- 영상은 보통 몇 분이 걸리고, 요청이 몰리면 더 걸립니다.
GET /v1/videos/{id}를 15–30초 간격으로 계속 확인하세요. status가failed면 금액은 자동으로 전액 환불됩니다. 콘솔 로그에서 환불 내역을 확인할 수 있습니다.- 접수 후 3시간이 지나도 끝나지 않으면
video_generation_timeout으로 실패 처리하고 환불합니다. - 환불 내역이 보이지 않는다면 작업
id(video_…)를 준비해 고객센터로 문의하세요.
이미지 결과 시간 초과 (result_timeout)
result_timeout은 요청이 접수는 됐지만 대기 시간 안에 결과가 오지 않았다는 뜻입니다. 요청 내용이 잘못된 것은 아닙니다.
- 잠시 기다린 뒤 같은 요청을 다시 보내세요.
- 같은 오류가 반복되면
n을 줄이거나 잠시 뒤에 시도하세요. - 차감 여부는 콘솔 로그에서 확인할 수 있습니다.
그래도 해결되지 않으면
오류 응답 전체(error.message, error.code), 요청 시각, 영상이라면 작업 id를 함께 알려 주시면 빠르게 확인할 수 있습니다. 고객센터 연락처는 페이지 아래에 있습니다.