화면 모드
이미지 만들기
텍스트 설명(프롬프트)으로 이미지를 만들고, 원하면 참조 이미지를 함께 넣어 인물·제품·분위기를 맞출 수 있습니다. 전체 파라미터는 이미지 생성 레퍼런스에 있습니다.
어떤 모델을 쓸까
| 모델 | 설명 |
|---|---|
seedream-5.5 | 이미지 생성 모델 |
seedream-5.0-flash | 이미지 생성 모델 (Flash) |
두 모델 모두 같은 파라미터(size, n, images, resolution)를 씁니다. 모델별 요금은 요금·결제를 보세요.
기본: 프롬프트로 한 장
bash
curl https://api.lool.chat/v1/images/generations \
-H "Authorization: Bearer $LOOL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5.5",
"prompt": "한옥 마당의 오후, 처마 그림자, 필름 사진 느낌",
"size": "1792x1024"
}'세로·가로 비율 고르기
size는 결과 이미지의 가로세로 비율을 정하는 데 쓰입니다.
size | 비율 | 이런 곳에 |
|---|---|---|
1024x1024 | 1:1 | 프로필, 썸네일 |
1792x1024 | 가로형 | 배너, 영상 배경 |
1024x1792 | 세로형 | 쇼츠·릴스, 모바일 화면 |
화질은 resolution으로 정합니다. 기본값은 "2k"이고 "1.5k"도 고를 수 있습니다.
여러 장 한 번에
n에 1–4를 넣으면 한 번에 그만큼 만듭니다. 이미지 요금은 장당으로 계산되므로 n만큼 금액이 늘어납니다.
json
{ "model": "seedream-5.5", "prompt": "미니멀한 커피 브랜드 로고 시안", "n": 4 }참조 이미지 넣기
images에 참조할 이미지의 URL 배열을 넣습니다. 인물 얼굴, 제품 사진, 원하는 화풍 등을 함께 주면 결과가 그쪽으로 맞춰집니다.
json
{
"model": "seedream-5.5",
"prompt": "첫 번째 이미지의 인물이 두 번째 이미지의 카페에 앉아 있는 장면",
"images": [
"https://example.com/person.png",
"https://example.com/cafe.jpg"
],
"size": "1024x1792"
}참조 이미지 주소
lool.chat 서버가 내려받을 수 있는 공개 URL이어야 합니다. 로그인이 필요한 주소나 사내망 주소는 읽을 수 없습니다.
결과 받기
응답은 보통 30–60초 뒤에 옵니다. 요청을 보내는 쪽의 타임아웃을 넉넉하게(예: 120초 이상) 잡아 두세요.
json
{
"created": 1763337600,
"data": [
{ "url": "https://api.lool.chat/files/20261117/…/….png" }
]
}data[].url은 https://api.lool.chat/files/{YYYYMMDD}/{작업ID}/{파일명} 형식의 고정 주소입니다. 열 때마다 새 다운로드 링크로 이동(302)하므로, 내려받는 프로그램은 리다이렉트를 따라가도록 설정하세요.
주소 공유에 주의하세요
결과는 lool.chat 저장소에 보관되며 같은 주소로 언제든 다시 받을 수 있습니다. 주소를 아는 사람은 누구나 받을 수 있으니 외부 공유에 주의하세요.
파일로 내려받으려면 이렇게 합니다.
python
import os, requests
from openai import OpenAI
client = OpenAI(api_key=os.environ["LOOL_API_KEY"], base_url="https://api.lool.chat/v1")
result = client.images.generate(model="seedream-5.5", prompt="한옥 마당의 오후", size="1024x1024")
for i, item in enumerate(result.data):
with open(f"result-{i}.png", "wb") as f:
f.write(requests.get(item.url, timeout=60).content)결과가 대기 시간 안에 오지 않으면 result_timeout 오류가 올 수 있습니다. 문제 해결을 보세요.