everyais
← 문서 목록

엔드포인트

이미지 편집

POST/v1/images/edits

모델 불러오는 중…

본문

modelstring필수
편집을 지원하는 모델 ID
promptstring필수
1–16,000자. 모델에 따라 상한이 더 낮을 수 있습니다
imagestring | file | array필수
원본 이미지. JSON은 base64 문자열, multipart는 파일 파트. FLUX 3 Image Klein은 참조 이미지 1–10장을 배열로 받습니다
maskstring | file선택
편집할 영역을 표시한 마스크. capabilities.image_mask가 true인 모델만
ninteger선택
생성할 이미지 수 1–4 (기본 1)
sizestring선택
WxH 픽셀(256x256 · 512x512 · 1024x1024 · 1792x1024 · 1024x1792 · 1536x1024 · 1024x1536 등), auto, 또는 해상도 등급. 규칙은 생성과 같습니다
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
response_formatstring선택
url(기본) · b64_json
quality / output_format / output_compression / background선택
이미지 생성과 같습니다. 지원하는 모델만
extra_body.googleobject선택
deprecated. aspect_ratio·image_size는 aspect_ratio·resolution의 옛 이름입니다. multipart에서는 JSON 문자열로 보냅니다
extra_body.gpunodeobject선택
FLUX 3 Image Klein 등 지원 모델만. seed · num_inference_steps · prompt_upsampling. multipart에서는 JSON 문자열로 보냅니다
prompt_upsamplingboolean선택
FLUX 3 Image Klein 전용. 생성과 같습니다. multipart에서는 true/false
userstring선택
최종 사용자 식별자

요청 본문은 multipart 전체 4 MiB, JSON 5 MiB까지입니다. 파일은 base64 인코딩 후 크기가 5 MiB 이하여야 합니다. 넘으면 413 request_too_large 또는 invalid_request_error입니다.

모델 옵션

모델별 지원값은 GET /v1/models의 capabilities, limits, parameter_constraints에 있습니다. 페이지 위쪽에서 모델을 고르면 표로 보입니다. 지원하지 않는 값은 조정되거나 400이 됩니다(파라미터 정책). 화면비와 해상도 규칙은 이미지 생성과 같습니다. 크기, 화면비, 해상도를 모두 생략하면 모델 기본값(대개 입력 이미지 비율)을 따릅니다.

FLUX 3 Image Klein 편집

모델 ID는 everyais/flux-3-image-klein입니다.

  • image에 이미지 1장이나 참조 이미지 1–10장 배열(JPEG, PNG, WebP)을 넣습니다. JSON은 base64나 data URL, multipart는 image 또는 image[] 파트를 반복합니다. 본문 한도가 같으니 참조 이미지는 압축하세요.
  • 크기 목록, 나머지 옵션, 가격은 생성과 같고, 출력 등급 기준으로 n장만큼 청구합니다. 마스크는 받지 않습니다.
  • size를 생략하거나 auto로 주면 첫 참조 이미지를 따릅니다. 참조가 1장이면 같은 화면비로 4MP·한 변 4096px 이하에 맞추고, 여러 장이면 첫 참조를 1MP 아래 16의 배수로 줄입니다. 가격은 가장 가까운 등급으로 매기고, 실제 출력 크기는 응답 최상위 size에 있습니다.
  • aspect_ratio만 주면 그 화면비의 1K 크기, resolution만 주면 첫 참조 화면비에 가장 가까운 그 등급 크기입니다.
  • 프롬프트에서 참조 이미지는 순서로 가리킵니다("첫 번째 이미지", 박스 편집에서는 <ref_image_0>). 편집할 때도 완성될 이미지 전체를 묘사하세요.
  • 박스 편집은 프롬프트 끝에 {"id","from":"ref_image_0"|null,"src_bbox","tgt_bbox","desc"} 목록을 붙입니다. 좌표는 0–1000 격자이고, tgt_bbox: null은 그 요소를 지웁니다. 박스는 위치와 크기의 힌트이며 정확한 마스크가 아닙니다.
json
{
  "model": "everyais/flux-3-image-klein",
  "prompt": "Move the <mug> from the first image to the right side of the table. [{\"id\":\"mug\",\"from\":\"ref_image_0\",\"src_bbox\":[600,100,800,250],\"tgt_bbox\":[600,650,800,800],\"desc\":\"white ceramic mug\"}]",
  "image": ["<base64-encoded-image>"],
  "n": 1
}
문의접수