화면 모드
이미지 생성
POST/v1/images/generations
프롬프트와 선택적 참조 이미지로 이미지를 만듭니다. 응답은 보통 30–60초 걸리므로 HTTP 클라이언트의 타임아웃을 넉넉하게 잡으세요.
요청 본문
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
model | string | 필수 | seedream-5.5 또는 seedream-5.0-flash |
prompt | string | 필수 | 만들 이미지 설명 |
size | string | 선택 | "1024x1024", "1792x1024", "1024x1792" 등. 가로세로 비율로 변환되어 적용됩니다 |
n | integer | 선택 | 만들 장 수, 1–4 |
images | string[] | 선택 | 참조 이미지 URL 배열 |
resolution | string | 선택 | "2k"(기본) 또는 "1.5k" |
size와 비율
size | 적용 비율 |
|---|---|
1024x1024 | 1:1 |
1792x1024 | 가로형 |
1024x1792 | 세로형 |
size는 비율을 정하는 값입니다. 결과 이미지의 실제 픽셀 크기는 resolution에 따라 달라질 수 있으니, 정확한 크기가 필요하면 받은 뒤 확인하세요.
응답
json
{
"created": 1763337600,
"data": [
{ "url": "https://api.lool.chat/files/20261117/…/….png" },
{ "url": "https://api.lool.chat/files/20261117/…/….png" }
]
}| 필드 | 설명 |
|---|---|
created | 생성 시각 (Unix 초) |
data[].url | 결과 이미지의 고정 주소 https://api.lool.chat/files/{YYYYMMDD}/{작업ID}/{파일명}. 열면 새 다운로드 링크로 302 이동합니다 |
결과 보관과 공유
결과는 lool.chat 저장소에 보관되며 같은 주소로 언제든 다시 받을 수 있습니다. 주소를 아는 사람은 누구나 받을 수 있으니 외부 공유에 주의하세요. 내려받을 때는 리다이렉트를 따라가도록 설정하세요(curl은 -L).
예시
bash
curl https://api.lool.chat/v1/images/generations \
-H "Authorization: Bearer $LOOL_API_KEY" \
-H "Content-Type: application/json" \
--max-time 180 \
-d '{
"model": "seedream-5.5",
"prompt": "흰 배경 위 무선 이어폰 제품 사진, 부드러운 그림자",
"size": "1024x1024",
"n": 2,
"resolution": "2k",
"images": ["https://example.com/product.png"]
}'python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["LOOL_API_KEY"],
base_url="https://api.lool.chat/v1",
timeout=180,
)
result = client.images.generate(
model="seedream-5.5",
prompt="흰 배경 위 무선 이어폰 제품 사진, 부드러운 그림자",
size="1024x1024",
n=2,
# OpenAI SDK에 없는 파라미터는 extra_body로 넘깁니다.
extra_body={
"resolution": "2k",
"images": ["https://example.com/product.png"],
},
)
for item in result.data:
print(item.url)js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.LOOL_API_KEY,
baseURL: "https://api.lool.chat/v1",
timeout: 180_000,
});
const result = await client.images.generate({
model: "seedream-5.5",
prompt: "흰 배경 위 무선 이어폰 제품 사진, 부드러운 그림자",
size: "1024x1024",
n: 2,
// 타입에 없는 필드도 그대로 전송됩니다.
resolution: "2k",
images: ["https://example.com/product.png"],
});
result.data.forEach((item) => console.log(item.url));오류
| HTTP | 상황 |
|---|---|
| 400 | 파라미터 형식이나 값이 잘못됨 |
| 401 | API 키가 없거나 잘못됨 |
| 402 | 잔액 부족 (insufficient_user_quota) |
| — | result_timeout: 접수됐지만 대기 시간 안에 결과가 오지 않음. 잠시 후 다시 시도하세요 |