메인 콘텐츠로 건너뛰기
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": "gpt-4o-image",
    "prompt": "바다 위의 생생한 색채의 아름다운 일몰",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/9998238784524590-549804af-14bc-4fbc-bae5-9d8469d35de3-image_task_01K889V97T2YF8RHQW21XMVMS1_0.png"
    ]
  }'
{
  "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": "gpt-4o-image",
    "prompt": "바다 위의 생생한 색채의 아름다운 일몰",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/9998238784524590-549804af-14bc-4fbc-bae5-9d8469d35de3-image_task_01K889V97T2YF8RHQW21XMVMS1_0.png"
    ]
  }'
{
  "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:"gpt-4o-image"
required
이미지 생성 모델 이름Example: "gpt-4o-image"
prompt
string
required
이미지 생성을 위한 텍스트 설명최대 1000자
size
string
이미지 생성 크기지원되는 형식:
  • 비율: 1:1, 2:3, 3:2
n
integer
생성할 이미지 수1, 2, 4를 지원합니다. 수량에 따라 요금이 사전 차감됩니다기본값: 1⚠️ 주의: 순수한 숫자를 입력하세요(예:1)。인용부호를 사용하면 오류가 발생합니다
image_urls
array
이미지-이미지 또는 이미지 편집을 위한 참조 이미지 URL 목록💡 빠른 입력 (Try it 영역):
  1. ”+ Add an item”을 클릭하여 이미지 URL 추가
  2. 이미지의 전체 URL 주소 입력
제한: 최대 5개 이미지
mask_url
string
마스크 이미지 URL
  • PNG 형식이어야 합니다
  • 크기는 참조 이미지와 일치해야 합니다
  • 최대 4MB

응답

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