everyais
← 문서 목록

엔드포인트

이미지 생성

POST/v1/images/generations

모델 불러오는 중…

본문

modelstring필수
IMAGE 카테고리 모델 ID
promptstring필수
1–16,000자. 공급자별 상한이 더 낮으면 그 공급자가 거부할 수 있습니다
ninteger선택
생성할 이미지 수 1–10 (기본 1)
sizestring선택
WxH 픽셀·auto(256x256 · 512x512 · 1024x1024 · 1792x1024 · 1024x1792 · 1536x1024 · 1024x1536 · auto 등) 또는 해상도 등급(resolution 과 같은 값). 픽셀이 우선하며 aspect_ratio·resolution 과 어긋나면 400
aspect_ratiostring선택
1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 4:5 · 5:4 · 1:2 · 2:1 · 7:5 · 5:7 · 1:4 · 4:1 · 1:8 · 8:1 · 9:21 · 21:9 · auto(공급자 기본). 모델별 허용값은 아래 화면비·해상도 참고
resolutionstring선택
512 · 768 · 1K · 1.5K · 2K · 4K. 1K≈100만 픽셀, 2K≈400만 픽셀, 4K 는 모델의 최대 등급
qualitystring선택
standard · hd · low · medium · high · xhigh · max · auto — 선택한 모델의 지원 옵션 확인(xhigh·max 는 GPT Image 2.5)
response_formatstring선택
url(기본) · b64_json
output_formatstring선택
png · jpeg · webp. parameter_profile 에 output_format 이 있는 모델만 받고 나머지는 400
output_compressioninteger선택
0–100. jpeg·webp 출력에만(GPT Image)
backgroundstring선택
transparent · opaque · auto(GPT Image). 투명은 png·webp 출력과 함께
moderationstring선택
low · auto(GPT Image)
userstring선택
최종 사용자 식별자
extra_body.googleobject선택
deprecated — aspect_ratio·image_size 는 위 aspect_ratio·resolution 의 별칭입니다. 값이 다르면 400
extra_body.gpunodeobject선택
관리형 GPU 노드 이미지 모델 전용: seed(같은 값이면 같은 결과, n장은 seed+i) · num_inference_steps
prompt_upsamplingboolean선택
FLUX 3 Image Klein 전용: 프롬프트 업샘플러 켜기/끄기(기본 true). 다른 모델은 400

화면비·해상도

모델마다 parameter_profile.tasks["image-generation"].parameters 의 aspect_ratio·resolution 이 지원값을 공개합니다(Playground 도 같은 값을 씁니다). 기본 정책 auto 는 지원하지 않는 화면비를 가장 가까운 값으로, 해상도를 요청 이하의 가장 가까운 등급(없으면 가장 작은 등급)으로 맞추고 x_everyais.parameter_warnings 로 알립니다. strict 는 400 입니다.

모델전송 방식
Gemini 이미지imageConfig 의 화면비·크기. 픽셀 size 는 가장 가까운 화면비·등급으로 바뀝니다(3840x2160 → 16:9·4K)
GPT Image 2.516의 배수 WxH 로 변환 — 1K≈100만 픽셀(16:9 1360x768), 2K≈400만 픽셀(2720x1536), 4K 는 픽셀 상한(3840x2160)
크기 목록 모델(FLUX 3 Image Klein 등)공개된 크기 목록에서 화면비 → 해상도 순으로 고릅니다. 크기별 단가(pricing.variants[].meta.sizes)는 고른 크기를 따릅니다

선택한 모델의 n 상한과 허용 크기(limits.supported_sizes)를 확인하세요. GPT Image 2.5 는 WIDTHxHEIGHT 임의 크기(16의 배수, 변 ≤3840, 비율 1:3–3:1, 655,360–8,294,400 픽셀)를 받습니다. 토큰 과금 이미지 모델은 큰 해상도·높은 품질일수록 출력 토큰이 늘어 청구액이 커집니다. 크기별 단가가 다르면 pricing.variants[] 의 meta.sizes 에 해당 크기가 있습니다. 사용 가능한 이미지 모델은 GET /v1/models 에서 category 가 IMAGE 인 항목을 확인하세요.

FLUX 3 Image Klein (everyais/flux-3-image-klein)

Black Forest Labs 의 FLUX 3 Image Klein(5.6B 오픈 웨이트, Qwen3-VL-4B 텍스트 인코더)입니다.

항목값
prompt최대 16,000자 (이미지 엔드포인트 공통)
n1–4
크기아래 60개 크기 중 하나(size) 또는 aspect_ratio + resolution. 기본 1:1·1K(1024x1024)
output_formatpng · jpeg · webp (엔진 기본 jpeg)
extra_body.gpunode.seed0–2147483647
extra_body.gpunode.num_inference_steps1–16 (기본 16)
prompt_upsamplingboolean, 기본 true — BFL 프롬프트 업샘플러가 프롬프트를 전체 캡션으로 다시 써서 생성합니다(BFL 자체 API 와 동일, 파라미터 이름도 같음). false 면 입력한 그대로 보냅니다. extra_body.gpunode.prompt_upsampling 도 같은 스위치입니다(둘 중 하나만, 또는 같은 값으로)
guidance_scale · negative_prompt미지원 — 400

업샘플링이 실행되면 응답 항목에 업샘플된 캡션이 revised_prompt 로 담깁니다.

지원 크기 (15개 화면비 × 4개 해상도)

해상도 768 · 1K · 1.5K · 2K(BFL 표기 768sq/1k/1.5k/2k). 픽셀 크기는 round16(E·√r) × round16(E/√r) 이며 E 는 768/1024/1536/2048, r 은 가로÷세로입니다. 명시한 size 는 이 60개 중 하나여야 합니다. BFL 의 4k 등급은 제공하지 않습니다 — 이 노드(GPU 1장, 96GB)에서 4K 한 장이 2분을 넘고 일부 화면비는 메모리가 부족했습니다. resolution: "4K" 는 auto 에서 2K 로 맞춰지고 strict 에서 400 입니다. 기본 정책 auto 는 가장 가까운 목록 크기로 맞추고 x_everyais.parameter_warnings 로 알리며, strict 는 400 입니다.

화면비7681K1.5K2K
21:91168x4961568x6722352x10083136x1344
2:11088x5441456x7202176x10882896x1456
16:91024x5761360x7682048x11522736x1536
3:2944x6241248x8321888x12482512x1680
7:5912x6561216x8641824x12962416x1728
4:3880x6721184x8801776x13282368x1776
5:4864x6881152x9121712x13762288x1824
1:1768x7681024x10241536x15362048x2048
4:5688x864912x11521376x17121824x2288
3:4672x880880x11841328x17761776x2368
5:7656x912864x12161296x18241728x2416
2:3624x944832x12481248x18881680x2512
9:16576x1024768x13601152x20481536x2736
1:2544x1088720x14561088x21761456x2896
9:21496x1168672x15681008x23521344x3136

가격 (이미지당, USD)

출력 등급가격
768$0.008
1K$0.009
1.5K$0.011
2K$0.014

생성과 편집의 가격은 같고 n 만큼 곱해집니다. 실제 청구액은 계정 요율을 따릅니다.

바운딩 박스 레이아웃

프롬프트 끝에 JSON 목록을 덧붙여 배치를 지정합니다. 각 요소는 {"id","bbox":[top,left,bottom,right],"desc"} 이고 좌표는 0–1000 격자입니다. 캡션 본문에서 요소를 <id> 로 지칭합니다.

json
{
  "model": "everyais/flux-3-image-klein",
  "prompt": "A cozy cafe window scene: a <cat> sleeps on the left windowsill and a <plant> stands on the right. [{\"id\":\"cat\",\"bbox\":[500,50,900,450],\"desc\":\"orange tabby cat curled up\"},{\"id\":\"plant\",\"bbox\":[300,600,900,900],\"desc\":\"potted monstera\"}]",
  "aspect_ratio": "3:2",
  "resolution": "1K",
  "extra_body": { "gpunode": { "seed": 42 } }
}

팁

  • 짧은 프롬프트보다 장면 전체를 서술한 캡션이 좋습니다.
  • 네거티브 프롬프트가 없습니다. 있어야 할 것을 묘사하세요.
  • 이미지에 넣을 글자는 따옴표로 감싸세요.
  • 지연 시간은 크기·참조 수·업샘플러에 따라 다릅니다. 2026-10-16 실측(GPU 처리 시간, 대기열·전송 제외): 업샘플러를 켜면 768 약 5초, 1K 6–8초, 1.5K 약 9초, 2K 약 16초, 참조 2–3장 편집 12–15초, 참조 10장 편집 약 55초. 업샘플러를 끄면 1K 약 2초입니다. 노드 1대가 한 번에 한 장씩 처리하므로 몰리면 대기 시간이 더해집니다(고정 SLA 없음).
  • 라이선스는 FLUX Kommunity License(비상업 + 자격을 갖춘 사용자의 출력물 상업 이용)입니다. 생성물은 콘텐츠(NSFW) 필터를 거치며 AI 가 생성한 이미지입니다.

모델 옵션

선택한 모델에서 되는 값은 위 표에서 확인하세요(API에서는 GET /v1/models의 capabilities·limits·parameter_constraints). 지원하지 않는 값을 보냈을 때 값을 조정하는지 400으로 거부하는지는 모델 선택과 접근 정책의 파라미터 정책을 보세요.

크기·화면비·해상도·품질을 생략하면 parameter_profile 의 defaults 를 사용합니다. 품질은 limits.supported_qualities를 확인하세요.

반환값

url 은 10분 유효한 presigned URL 입니다. 오래 보관하려면 직접 내려받아 저장하세요. 만료된 뒤에는 GET /v1/outputs/{requestId} 로 24시간 안에 다시 발급받을 수 있습니다. requestId는 이 응답의 x-request-id 헤더 값입니다(x-everyais-operation-id에도 같은 값). 응답 본문에는 없으니 헤더를 함께 저장하세요.

문의접수