메인 콘텐츠로 건너뛰기
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": "gpt-image-1-official",
    "prompt": "별이 빛나는 하늘 아래의 고대 성",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "별이 빛나는 하늘 아래의 고대 성",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

​
지원 모델

모델명설명모드이미지-이미지최대 장수과금 방식
gpt-image-1-official안정성 우선, 범용 이미지 생성에 적합텍스트-이미지 / 이미지-이미지지원4장크기×품질
gpt-image-1.5-official신규 버전, 고품질 및 복잡한 편집에 적합텍스트-이미지 / 이미지-이미지지원4장크기×품질

​
Authorizations

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

​
Body

​
model
string
필수
모델 이름
  • gpt-image-1-official - 안정성 우선, 범용 이미지 생성에 적합
  • gpt-image-1.5-official - 신규 버전, 고품질 및 복잡한 편집에 적합
​
prompt
string
필수
이미지 생성을 위한 텍스트 설명, 중국어와 영어 지원
​
size
string
기본값:"1:1"
화면 비율지원 비율:
  • 1:1 - 정사각형 (기본값)
  • 3:2 - 가로형
  • 2:3 - 세로형
​
n
integer
기본값:"1"
생성 이미지 수범위: 1-4
  • 0 이하의 값은 1로 처리됩니다
  • 4를 초과하는 값은 4로 처리됩니다
⚠️ 주의: 순수 숫자(예: 1)를 입력해야 합니다. 따옴표를 추가하면 오류가 발생합니다
​
quality
string
기본값:"auto"
이미지 품질
  • auto - 자동 품질 선택 (기본값)
  • low - 더 빠르고 경제적
  • medium - 품질과 비용의 균형
  • high - 더 높은 품질, 더 높은 비용
​
background
string
기본값:"auto"
배경 모드
  • auto - 자동 배경 (기본값)
  • opaque - 불투명 배경
  • transparent - 투명 배경, png 출력 형식과 함께 사용 권장
background: transparent와 output_format: jpeg는 동시에 사용할 수 없습니다
​
moderation
string
기본값:"auto"
검수 강도
  • auto - 기본 검수 강도
  • low - 더 관대한 검수
​
output_format
string
기본값:"png"
출력 형식
  • png - 기본 형식, 투명 배경에 적합
  • jpeg - 파일 크기가 작음, 일반 이미지 출력에 적합
background: transparent와 output_format: jpeg는 동시에 사용할 수 없습니다
​
output_compression
integer
출력 압축 수준, 범위 0-100
  • jpeg에서만 사용 권장
  • png에서는 설정 불필요
​
image_urls
array
참조 이미지 URL 배열, 제공 시 이미지-이미지 모드가 활성화됩니다제한: 최대 15장의 참조 이미지
​
mask_url
string
마스크 이미지 URL, 인페인팅용
  • image_urls와 함께 사용해야 합니다
  • 공식 편집 API를 통해 함께 제출됩니다
1、마스크 이미지를 업로드하기 전에 이미지의 Alpha 채널이 “예”인지 확인하세요.2、마스크 이미지 크기는 첫 번째 참조 이미지와 일치해야 합니다.

​
크기 참조표

화면 비율은 외부에서 사용되며, 시스템 내부에서 공식 실제 크기로 자동 매핑됩니다.
비율실제 크기설명
1:11024×1024정사각형
2:31024×1536세로형
3:21536×1024가로형

​
사용 예시

텍스트-이미지 (최소 요청) 
{
  "model": "gpt-image-1-official",
  "prompt": "별이 빛나는 하늘 아래의 고대 성"
}
텍스트-이미지 (전체 매개변수) 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
이미지-이미지 (단일 참조 이미지) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "참조 이미지를 일러스트 스타일로 변환하고 주요 윤곽을 유지",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
이미지-이미지 (다중 참조 이미지 융합) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "두 장의 참조 이미지를 일러스트 포스터로 융합하고 주요 윤곽을 유지",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
다중 생성 (n > 1) 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

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

​
주의사항

  1. 비동기 처리: 제출 후 task_id가 반환됩니다. /v1/tasks/{task_id}를 폴링하여 결과를 얻으세요
  2. 모델 선택: 범용 이미지 생성에는 gpt-image-1-official을 우선 사용. 고품질 편집 및 복잡한 이미지-이미지에는 gpt-image-1.5-official 권장
  3. 이미지 URL 요구사항: 이미지-이미지에는 공개적으로 접근 가능한 안정적인 이미지 URL을 사용하세요
  4. 과금 규칙: 성공적으로 생성된 이미지 수에 따라 과금, 실패 시 과금 없음