화면 모드
API 개요와 인증
lool.chat API는 OpenAI API와 같은 형식의 HTTP·JSON API입니다.
기본 주소
https://api.lool.chat/v1인증
콘솔 토큰 메뉴에서 만든 API 키를 Authorization 헤더에 Bearer 토큰으로 넣습니다. API 키 만들기
http
Authorization: Bearer 발급받은_키
Content-Type: application/json엔드포인트
| 메서드 | 경로 | 설명 |
|---|---|---|
POST | /v1/images/generations | 이미지 생성 |
POST | /v1/videos | 영상 생성 접수 |
GET | /v1/videos/{id} | 영상 상태 조회 |
GET | /v1/videos/{id}/content | 영상 파일 받기 |
GET | /v1/models | 모델 목록 |
오류 형식
오류가 나면 HTTP 상태 코드와 함께 아래 형식의 본문이 옵니다.
json
{
"error": {
"message": "seconds must be an integer between 4 and 15",
"type": "invalid_request_error",
"code": "invalid_request"
}
}| 필드 | 설명 |
|---|---|
message | 사람이 읽을 수 있는 설명 (영어) |
type | 오류 분류 |
code | 프로그램에서 분기할 때 쓰는 코드 |
코드별 뜻과 대응 방법은 오류 코드에 있습니다.
결과 파일 주소
이미지·영상 결과로 받는 url은 만료 없는 고정 주소입니다.
https://api.lool.chat/files/{YYYYMMDD}/{작업ID}/{파일명}이 주소를 열면 그때마다 새 다운로드 링크로 302 리다이렉트합니다. 내려받는 프로그램은 리다이렉트를 따라가도록 설정하세요(curl은 -L, Python requests와 Node.js fetch는 기본으로 따라갑니다).
주소 공유에 주의하세요
결과는 lool.chat 저장소에 보관되며 같은 주소로 언제든 다시 받을 수 있습니다. 주소를 아는 사람은 누구나 받을 수 있으니 외부 공유에 주의하세요.