메인 콘텐츠로 건너뛰기
POST
https://api.apimart.ai
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-2-flex",
    "prompt": "잔디 위의 파란 고양이",
    "resolution": "1K",
    "size": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KFG5BBFNK1YQDTJDZY0P0QT2"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-2-flex",
    "prompt": "잔디 위의 파란 고양이",
    "resolution": "1K",
    "size": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KFG5BBFNK1YQDTJDZY0P0QT2"
    }
  ]
}

​
지원되는 모델

모델명설명과금 방식
flux-2-flexFlux 2.0 Flex 이미지 생성 모델 (빠름, 빠른 반복에 적합)해상도별 과금 (1K/2K)
flux-2-proFlux 2.0 Pro 이미지 생성 모델 (더 높은 품질, 더 나은 디테일)해상도별 과금 (1K/2K)

​
인증

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

​
Body

​
model
string
필수
모델 이름
  • flux-2-flex - Flux 2.0 Flex 모델 (빠름, 빠른 반복에 적합)
  • flux-2-pro - Flux 2.0 Pro 모델 (더 높은 품질, 더 나은 디테일)
​
prompt
string
필수
이미지 생성을 위한 텍스트 설명
​
resolution
string
기본값:"1K"
이미지 해상도지원되는 해상도:
  • 1K - 기본값, 1080p 수준
  • 2K - HD, 최대 2048 픽셀
대소문자 구분 없음: 1k, 1K, 2k, 2K 모두 사용 가능
​
size
string
기본값:"1:1"
이미지 가로세로 비율지원되는 가로세로 비율:
  • 1:1 - 정사각형 (기본값)
  • 4:3 - 가로
  • 3:4 - 세로
  • 16:9 - 와이드스크린
  • 9:16 - 세로
  • 3:2 - 클래식 가로
  • 2:3 - 클래식 세로
위 7가지 비율만 지원, 지원되지 않는 비율은 오류 반환
​
image_urls
array
참조 이미지 URL 목록제한:
  • 최대 8장
  • 공개적으로 접근 가능한 URL이어야 함
  • Base64 형식은 지원되지 않음

​
해상도 참조 표

비율이름1K 크기2K 크기
1:1정사각형1440×14401536×1536
4:3가로1664×12481824×1368
3:4세로1248×16641368×1824
16:9와이드스크린1920×10802048×1152
9:16세로1080×19201152×2048
3:2클래식 가로1728×11521872×1248
2:3클래식 세로1152×17281248×1872

​
사용 예시

기본 텍스트-이미지 
{
    "model": "flux-2-flex",
    "prompt": "파란 고양이",
    "resolution": "1K",
    "size": "16:9"
}
고해상도 생성 
{
    "model": "flux-2-pro",
    "prompt": "산과 강이 있는 세밀한 풍경화",
    "resolution": "2K",
    "size": "16:9"
}
이미지-이미지 (최대 8장 참조 이미지) 
{
    "model": "flux-2-flex",
    "prompt": "이미지를 수채화 스타일로 변환",
    "image_urls": [
        "https://example.com/input1.jpg",
        "https://example.com/input2.jpg"
    ],
    "resolution": "1K"
}

​
Response

​
code
integer
응답 상태 코드
​
data
array
응답 데이터 배열

​
주의사항

  1. 이미지 URL 요구사항: 입력 이미지는 공개적으로 접근 가능한 URL이어야 합니다, base64는 지원되지 않습니다
  2. 결과 저장: 생성된 이미지는 자동으로 저장되며, URL은 24시간 동안 유효합니다
  3. 작업 폴링: 작업은 비동기로 처리됩니다, 결과를 얻으려면 /v1/tasks/{task_id}를 폴링하세요
  4. 입력 이미지 제한: 최대 8장까지 지원