메인 콘텐츠로 건너뛰기
POST
/
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": "gemini-2.5-flash-image-preview",
    "prompt": "네온 불빛이 있는 현대 도시 야경",
    "size": "1:1",
    "n": 1
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "네온 불빛이 있는 현대 도시 야경",
    "size": "1:1",
    "n": 1
  }'

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

​
인증

​
Authorization
string
required
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 획득 방법:API 키 관리 페이지를 방문하여 API 키를 획득하세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

​
요청 본문

​
model
string
default:"gemini-2.5-flash-image-preview"
required
이미지 생성 모델 이름Example: "gemini-2.5-flash-image-preview"
​
prompt
string
required
이미지 생성을 위한 텍스트 설명최대 1000자
​
size
string
이미지 생성 크기지원되는 형식:
  • 비율: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
​
n
integer
default:"1"
생성할 이미지 수1로 고정
​
image_urls
array
이미지-이미지 또는 이미지 편집을 위한 참조 이미지 URL 목록
  • 최대 5개의 이미지
  • 각 이미지는 10MB를 초과하지 않아야 합니다
  • 지원 형식: .jpeg, .jpg, .png, .webp
​
mask_url
string
마스크 이미지 URL
  • PNG 형식이어야 합니다
  • 크기는 참조 이미지와 일치해야 합니다
  • 최대 4MB

​
응답

​
created
integer
작업 생성 타임스탬프
​
id
string
고유한 작업 식별자
​
model
string
실제로 사용된 모델 이름
​
object
string
객체 유형, image.generation.task로 고정
​
progress
integer
작업 완료 진행률 (0-100)
​
status
string
작업 상태가능한 값:
  • pending - 처리 대기 중
  • processing - 진행 중
  • completed - 완료됨
  • failed - 실패
​
task_info
object
작업 세부 정보
​
type
string
출력 유형, image로 고정
​
usage
object
청구 정보