FLUX 3 Image Klein

간단한 예제

이미지 한 장의 요청을 제출하고 반환된 id를 저장한 뒤 작업이 completed 또는 failed가 될 때까지 폴링합니다. 이 API는 비동기 작업을 사용하며 URL로 결과를 반환합니다.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

엔드포인트와 헤더

POST https://api.seedrouter.ai/v1/images/generations

키는 서버에 보관합니다. HTTP 성공은 작업이 접수되었다는 의미이며 이미지가 준비되었다는 뜻은 아닙니다.

파라미터

허용되는 필드는 11개입니다. model과 prompt만 필수입니다. 선택 필드를 생략하면 기본값을 사용하며 null은 허용되지 않습니다.

비율: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

Playground는 고정 모델과 열 개의 입력 컨트롤을 제공하며, 1로 고정된 n도 포함됩니다. 관리자를 제외하면 2보다 큰 안전 값은 API에서만 사용합니다.

모드와 제약

참조가 없으면 텍스트로 이미지를 생성합니다. 참조 한 장은 편집, 여러 장은 이미지 조합에 사용합니다. auto 편집은 첫 참조의 화면 비율을 따릅니다. 텍스트 전용 생성은 프롬프트로 화면 비율을 선택하고 판단하지 못하면 1:1을 사용합니다. 모든 모드의 해상도 기본값은 1k입니다.

해상도 단계는 대략적인 이미지 규모입니다. 768sq는 약 768 × 768, 1K는 약 1 MP, 1.5K는 약 2 MP, 2K는 약 4 MP, 4K는 약 16 MP입니다. 실제 크기는 반환 파일에서 확인합니다.

이 엔드포인트는 width, height, size의 픽셀 크기, negative_prompt, guidance, grounding, prompt_upsampling, mask, mask_url을 받지 않습니다. 알 수 없는 필드는 과금 전에 HTTP 400을 반환합니다. WebP 출력, base64 입력, 스트리밍, 콜백은 제공하지 않습니다.

참조 이미지와 영역 편집

제출 전에 참조를 공개 URL에 업로드합니다. 요청 본문에는 URL을 넣으며 파일 바이트나 data URL은 넣지 않습니다.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

예시 URL을 접근 가능한 본인 이미지로 바꿉니다. 참조에는 순서가 있으며 첫 번째는 ref_image_0입니다. 경계 상자 지시는 별도 필드가 아닌 prompt 문자열에 포함합니다. 좌표는 [y1, x1, y2, x2]를 쓰고 0–1000으로 정규화합니다. 레이아웃 객체는 id, bbox, desc를, 편집은 id, from, src_bbox, tgt_bbox, desc를 사용할 수 있습니다. 프롬프트 안의 따옴표를 올바르게 이스케이프하도록 요청 전체를 JSON 인코딩합니다.

과금

성공한 요청 한 건은 이미지 한 장입니다. 선택한 해상도만 가격을 결정하며 스텝, 시드, 화면 비율, 참조 수, 형식에는 추가 요금이 없습니다. 텍스트 생성과 편집은 같은 요금입니다. 실패한 요청은 과금되지 않습니다. 실시간 가격을 확인합니다.

작업 응답과 폴링

제출 응답:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

완료된 작업(URL은 예시):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

output.data[0].url을 읽습니다. 특히 4K에서는 생성에 최대 십 분을 허용합니다. 폴링은 읽기 전용입니다. 클라이언트 시간 초과가 다른 유료 요청을 제출할 권한을 뜻하지는 않습니다. 공개 작업 응답에는 비용이나 계정 잔액이 포함되지 않습니다.

오류

HTTP 오류는 {"error": {"code": integer, "message": string}} 형식을 사용합니다. 공통 오류 목록을 확인합니다. 실패한 작업은 status: "failed"와 함께 오류를 표시합니다. 다시 제출하기 전에 잘못된 파라미터를 수정하며 이미 제출한 요청은 작업 ID를 보관해 조회합니다.

팁과 관련 가이드

긍정형으로 설명하고 유지할 영역이나 세부 내용을 지정합니다. 스텝을 줄이면 품질이 달라질 수 있지만 가격은 내려가지 않습니다. 한 번에 한 가지씩 바꾸며 비교합니다.

• FLUX 3 Image Klein Playground
• 다운로드, 가중치, ComfyUI 가이드
• 작업 수명 주기