Skip to main content
POST

지원 모델

Flex 전용으로 표시된 매개변수를 제외하면 아래 매개변수와 픽셀 제한은 세 모델에 모두 적용됩니다.

인증

string
필수
모든 엔드포인트에는 Bearer Token 인증이 필요합니다.API Key 받기:API Key 관리 페이지에서 API Key를 받으세요.요청 헤더에 다음 값을 추가합니다:

Body

string
필수
모델 이름:
  • flux-2-flex - 세밀한 제어를 지원하는 Flex 모델
  • flux-2-pro - 범용 Pro 모델
  • flux-2-max - 최고 품질의 Max 모델
boolean
기본값:"false"
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
이미지 생성 또는 편집 내용을 설명하는 텍스트입니다.
string
기본값:"2MP"
출력 해상도 등급:
  • 1MP
  • 2MP - 기본값
  • 3MP
  • 4MP
여기서 1MP는 1,048,576픽셀입니다.호환 별칭: 512 / 512P / 1M1MP, 1K / 10242MP, 2K / 20483MP, 4K4MP와 같습니다. 다른 값은 거부됩니다.실제 출력 크기는 size에도 따라 달라집니다.
string
기본값:"1:1"
출력 이미지의 가로세로 비율 또는 픽셀 크기입니다.sizeauto도 지원합니다. image_urls를 전달하면 현재 resolution 단계를 유지하면서 참조 이미지의 가로세로 비율을 따릅니다. 참조 이미지가 없으면 기본 1:1로 처리됩니다.다음 크기 옵션을 지원합니다:
  • 1:1 - 정사각형(기본값)
  • 4:3 - 가로
  • 3:4 - 세로
  • 16:9 - 와이드스크린
  • 9:16 - 세로
  • 3:2 - 클래식 가로
  • 2:3 - 클래식 세로
  • 21:9 - 울트라와이드
  • 9:21 - 울트라 세로
  • auto - 참조 이미지의 가로세로 비율 따름
"너비x높이" 형식의 픽셀 문자열도 지정할 수 있습니다. 예: "1024x1536".
integer
정확한 출력 너비(픽셀 단위)입니다. height와 함께 지정해야 하며 각 값은 64 이상이어야 합니다.둘 중 하나만 지정하면 작업이 실패합니다.
integer
정확한 출력 높이(픽셀 단위)입니다. width와 함께 지정해야 하며 각 값은 64 이상이어야 합니다.총 출력 픽셀 수는 4MP를 초과할 수 없습니다. 즉, width × height ≤ 4,194,304여야 합니다.
array
이미지 기반 이미지 생성이나 다중 참조 이미지 합성에 사용하는 참조 이미지 목록입니다.제한:
  • 최대 8장의 이미지 지원
  • 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 입력 이미지 지원
  • 출력 이미지와 모든 참조 이미지의 총 픽셀 수는 9MP를 초과할 수 없음
string
기본값:"jpeg"
출력 이미지 인코딩 형식입니다. jpeg, png, webp를 지원하며 기본값은 jpeg입니다.
integer
기본값:"1"
생성할 이미지 수입니다. 값은 반드시 1이어야 합니다. 여러 장이 필요하면 작업을 여러 번 제출하세요.
integer
무작위 시드입니다. 동일한 시드와 다른 매개변수를 유지하면 동일한 결과를 재현할 수 있습니다. 생략하면 무작위로 생성됩니다.
boolean
기본값:"false"
프롬프트 강화를 활성화할지 여부:
  • true - 활성화
  • false - 비활성화(기본값)
false를 명시적으로 설정하면 프롬프트 재작성을 비활성화할 수 있습니다.
integer
기본값:"2"
콘텐츠 검토 허용 수준으로, 범위는 0~5입니다. 값이 높을수록 허용 수준이 높아집니다.
integer
기본값:"50"
샘플링 단계 수로, flux-2-flex에서만 지원합니다. 범위는 1~50입니다. 값이 높을수록 일반적으로 세부 묘사가 늘어나고 생성 시간이 길어집니다.
number
기본값:"5.0"
프롬프트 가이던스 강도로, flux-2-flex에서만 지원합니다. 범위는 1.5~10입니다. 값이 높을수록 일반적으로 생성 결과가 프롬프트에 더 충실해집니다.

해상도 대응표

크기 매개변수 우선순위

  1. widthheight를 함께 지정하면 정확한 픽셀 크기가 적용됩니다.
  2. size1024x1536 같은 픽셀 문자열을 지정하면 정확한 픽셀 크기가 적용됩니다.
  3. 그 외에는 resolutionsize의 비율을 기준으로 위 표에서 크기가 결정됩니다.
  4. 크기 값을 모두 생략하면 2MP1:1, 즉 1440×1440이 적용됩니다.
width 또는 height 중 하나만 지정할 수 없으며, 그렇게 제출하면 작업이 실패합니다.

사용 사례 예시

기본 텍스트 기반 이미지 생성
최고 품질 생성
정확한 픽셀 크기
다중 참조 이미지 합성
Flex 세밀 제어

Response

제출에 성공하면 data는 배열이며 작업 ID는 data[0].task_id에 있습니다.
integer
응답 상태 코드입니다.
array
응답 데이터 배열입니다.

작업 결과 조회

작업은 비동기로 처리됩니다. 제출 응답의 task_id로 다음 엔드포인트를 요청하고 상태가 completed 또는 failed가 될 때까지 폴링하세요:
작업 상태는 다음과 같습니다: 완료 응답 예시:
result.images[].url은 문자열 배열입니다. 이 시리즈는 요청당 이미지 1장만 생성하므로 url[0]을 사용하세요. 이미지 URL의 유효 기간은 동일한 객체의 expires_at Unix 타임스탬프를 따릅니다. 만료되기 전에 생성 결과를 저장하세요.

잘못된 모델 매개변수와 작업 실패

잘못된 모델 매개변수는 비동기로 반환됩니다. 제출 시에는 HTTP 200과 task_id가 반환되고, 작업을 조회하면 최종 상태가 failed로 바뀌며 구체적인 원인이 data.error.message에 표시됩니다. 따라서 작업이 최종 상태가 될 때까지 폴링해야 합니다.
이 유형의 오류에서 data.error.code는 항상 task_failed이며 구체적인 원인은 message에 표시됩니다. 실패한 작업은 전액 환불됩니다.

주의사항

  1. 크기 제한: 출력 이미지는 4MP를 초과할 수 없으며 너비와 높이는 각각 64픽셀 이상이어야 합니다.
  2. 총 픽셀 제한: 출력 이미지와 모든 참조 이미지의 총 픽셀 수는 9MP를 초과할 수 없습니다.
  3. 참조 이미지 요구사항: 참조 이미지는 최대 8개까지 지원하며 공개적으로 접근 가능한 이미지 URL 또는 Base64로 인코딩된 입력 이미지를 사용할 수 있습니다.
  4. 고정 생성 수: n은 반드시 1이어야 하며 요청당 이미지 1장만 생성합니다.
  5. 프롬프트 강화: prompt_upsampling은 기본적으로 비활성화됩니다.
  6. Flex 전용 매개변수: stepsguidanceflux-2-flex에만 적용됩니다.
  7. 비동기 작업: 제출에 성공한 후 /v1/tasks/{task_id}를 폴링하여 최종 결과를 가져오세요.