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 지원 여부 확인
ninteger선택
생성할 이미지 수 1–4 (기본 1)
sizestring선택
WxH 픽셀·auto(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선택
생성(/v1/images/generations)과 같은 의미. 지원 모델만
extra_body.googleobject선택
deprecated — aspect_ratio·image_size 는 aspect_ratio·resolution 의 별칭. multipart 에서는 JSON 문자열
extra_body.gpunodeobject선택
관리형 GPU 노드 모델 전용: seed · num_inference_steps · prompt_upsampling(FLUX 3 Image Klein). 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를 반환합니다. 픽셀 크기뿐 아니라 인코딩된 바이트 크기도 확인하세요.

모델 옵션

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

마스크는 capabilities.image_mask: true인 모델에서만 사용하세요. 화면비·해상도 지원값과 조정 규칙은 이미지 생성과 같습니다. 크기·화면비·해상도를 모두 생략하면 편집 결과는 공급자 기본값(대개 입력 이미지 비율)을 따릅니다.

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

  • image 는 이미지 1장 또는 1–10장 배열(참조 이미지)입니다. JSON 은 base64/data URL, multipart 는 image 또는 image[] 파트를 반복합니다. JPEG·PNG·WebP. 본문 한도는 그대로 multipart 4 MiB / JSON 5 MiB 이니 참조 이미지를 압축해 보내세요.
  • n·output_format·prompt_upsampling·extra_body.gpunode(seed·num_inference_steps)는 생성과 같습니다(multipart 에서 prompt_upsampling 은 true/false, extra_body 는 JSON 문자열). 가격도 생성과 같고 출력 등급 기준입니다(768 $0.008 · 1K $0.009 · 1.5K $0.011 · 2K $0.014, n 곱).
  • size 생략: 첫 참조 이미지를 따릅니다. 참조 1장이면 같은 화면비로 4MP·변 4096px 이하에 맞추고, 여러 장이면 첫 참조를 1MP 아래 16의 배수로 줄입니다. 가장 가까운 등급으로 과금됩니다. 지정하면 이미지 생성의 60개 크기 중 하나여야 합니다.
  • 프롬프트에서 참조는 위치로 지칭합니다("첫 번째 이미지", 박스 편집에서는 <ref_image_0>). 이 모델은 마스크가 없습니다.
  • 편집은 목표 이미지 전체를 서술하세요. 박스 편집은 프롬프트 끝에 JSON 목록을 덧붙입니다: {"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
}
문의접수