everyais
← 문서 목록

엔드포인트

이미지 생성

POST/v1/images/generations

모델 불러오는 중…

본문

modelstring필수
IMAGE 카테고리 모델 ID
promptstring필수
1–16,000자. 모델에 따라 상한이 더 낮을 수 있습니다
ninteger선택
생성할 이미지 수 1–10 (기본 1)
sizestring선택
WxH 픽셀(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선택
FLUX 3 Image Klein 등 지원 모델만. seed(같은 값이면 같은 결과, n장은 seed+i) · num_inference_steps
prompt_upsamplingboolean선택
FLUX 3 Image Klein 전용(기본 true). 다른 모델은 400

화면비·해상도

모델별 지원값은 parameter_profile.tasks["image-generation"].parameters의 aspect_ratio·resolution과 limits.supported_sizes에 있습니다. 기본 정책 auto에서는 지원하지 않는 화면비를 가장 가까운 값으로, 해상도를 요청 이하의 가장 가까운 등급(없으면 가장 작은 등급)으로 맞추고 x_everyais.parameter_warnings로 알립니다. strict에서는 400입니다.

모델크기 처리
Gemini 이미지픽셀 size를 가장 가까운 화면비와 등급으로 바꿉니다(3840x2160 → 16:9·4K)
GPT Image 2.516의 배수인 WxH로 바꿉니다. 1K는 약 100만 픽셀(16:9면 1360x768), 2K는 약 400만 픽셀(2720x1536), 4K는 3840x2160. 직접 지정한 WIDTHxHEIGHT는 16의 배수, 한 변 3840 이하, 비율 1:3–3:1, 655,360–8,294,400 픽셀이어야 합니다
크기 목록이 있는 모델(FLUX 3 Image Klein 등)목록에서 화면비, 해상도 순서로 고릅니다. 크기별 가격은 pricing.variants[].meta.sizes에 있습니다

토큰으로 과금하는 이미지 모델은 해상도와 품질이 높을수록 금액이 커집니다.

FLUX 3 Image Klein

모델 ID는 everyais/flux-3-image-klein입니다. Black Forest Labs의 5.6B 오픈 웨이트 모델입니다.

항목값
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_upsampling기본 true. 프롬프트를 자세한 캡션으로 다시 써서 생성하고, 다시 쓴 캡션을 응답의 revised_prompt에 담습니다(BFL API와 같은 동작). extra_body.gpunode.prompt_upsampling과 다른 값을 보내면 400
guidance_scale · negative_prompt지원하지 않습니다. 400

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

픽셀 크기는 round16(E·√r) × round16(E/√r)입니다(E는 768/1024/1536/2048, r은 가로÷세로). size: "auto"는 생략과 같습니다. 실제 출력 크기는 응답 최상위 size에 있습니다.

  • 4K는 지원하지 않습니다. 최대 크기는 2K입니다. resolution: "4K"는 auto에서 2K로 바뀌고 strict에서는 400입니다.
  • 목록에 없는 size는 auto에서 가장 가까운 화면비의 크기 중 요청보다 크지 않은 가장 큰 크기로 줄입니다(1024x768 → 880x672, 1920x1080 → 1360x768). 크기를 키우지는 않으므로 768x768보다 작으면 400입니다. 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장만큼 곱합니다. 실제 청구액은 계정 요율을 따릅니다.

바운딩 박스로 배치 정하기

프롬프트 끝에 {"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 } }
}

사용 팁

  • 짧은 프롬프트보다 장면 전체를 묘사한 캡션이 결과가 좋습니다. 네거티브 프롬프트가 없으니 있어야 할 것을 묘사하세요.
  • 이미지에 넣을 글자는 따옴표로 감싸세요.
  • 업샘플러를 끄면 더 빨리 생성됩니다.
  • 라이선스는 FLUX Kommunity License입니다(비상업 용도, 그리고 자격을 갖춘 사용자의 출력물 상업 이용). 생성물은 NSFW 필터를 거칩니다.

모델 옵션

모델별 지원값은 GET /v1/models의 capabilities, limits, parameter_constraints에 있습니다. 페이지 위쪽에서 모델을 고르면 표로 보입니다. 지원하지 않는 값은 조정되거나 400이 됩니다(파라미터 정책). 크기, 화면비, 해상도, 품질을 생략하면 parameter_profile의 defaults를 씁니다. 품질은 limits.supported_qualities를 확인하세요.

반환값

url은 10분 동안 유효한 presigned URL이니 바로 내려받으세요. 24시간 안에는 응답의 x-request-id 헤더 값으로 새 URL을 받을 수 있습니다.

문의접수