메인 콘텐츠로 건너뛰기
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-kontext-pro",
    "prompt": "머리 색깔을 파란색으로 변경",
    "image_urls": ["https://example.com/input.png"],
    "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-kontext-pro",
    "prompt": "머리 색깔을 파란색으로 변경",
    "image_urls": ["https://example.com/input.png"],
    "size": "16:9"
  }'

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

​
지원되는 모델

모델명설명과금 방식
flux-kontext-proFlux Kontext Pro 이미지 편집 모델고정 가격
flux-kontext-maxFlux Kontext Max 이미지 편집 모델 (더 높은 품질)고정 가격

​
인증

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

​
Body

​
model
string
필수
모델 이름
  • flux-kontext-pro - Kontext Pro 모델
  • flux-kontext-max - Kontext Max 모델 (더 높은 품질)
​
prompt
string
필수
이미지 생성을 위한 텍스트 설명
​
image_urls
array
입력 이미지 URL 목록제한:
  • 1장만 지원
  • 공개적으로 접근 가능한 URL이어야 함
  • Base64 형식은 지원되지 않음
​
size
string
기본값:"이미지 있음: match_input_image, 없음: 16:9"
이미지 가로세로 비율지원되는 가로세로 비율:
  • match_input_image - 입력 이미지 비율에 맞춤 (이미지 제공 시 기본값)
  • auto - match_input_image와 동일
  • 1:1 - 정사각형
  • 4:3 - 가로 4:3
  • 3:4 - 세로 3:4
  • 16:9 - 가로 와이드스크린 (이미지 없을 때 기본값)
  • 9:16 - 세로
  • 3:2 - 가로 3:2
  • 2:3 - 세로 2:3
  • 21:9 - 울트라 와이드
  • 9:21 - 울트라 톨
​
response_format
string
기본값:"png"
출력 이미지 형식
  • png - PNG 형식 (기본값)
  • jpg - JPEG 형식
​
safety_tolerance
integer
기본값:"2"
안전 허용치범위: 0-6, 값이 높을수록 더 관대함
​
prompt_upsampling
boolean
기본값:"false"
프롬프트 강화 활성화
  • true - 활성화
  • false - 비활성화 (기본값)

​
사용 예시

이미지 편집 (입력 이미지 포함) 
{
    "model": "flux-kontext-pro",
    "prompt": "배경을 해변으로 변경",
    "image_urls": ["https://example.com/photo.jpg"]
}
텍스트-이미지 (입력 이미지 없음) 
{
    "model": "flux-kontext-pro",
    "prompt": "파란 고양이",
    "size": "16:9"
}

​
Response

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

​
주의사항

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