메인 콘텐츠로 건너뛰기
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": "qwen-image-2.0",
    "prompt": "햇살 아래 낮잠 자는 귀여운 주황색 고양이"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "prompt": "햇살 아래 낮잠 자는 귀여운 주황색 고양이"
  }'

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

​
지원되는 모델

모델명설명최대 장수과금 방식
qwen-image-2.0표준 버전, 품질과 성능의 균형6장고정 가격
qwen-image-2.0-proPro 버전, 텍스트 렌더링이 강력하고 사실적 질감이 더 세밀6장고정 가격

​
인증

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

​
Body

​
model
string
필수
모델 이름
  • qwen-image-2.0 - 표준 버전, 품질과 성능의 균형
  • qwen-image-2.0-pro - Pro 버전, 텍스트 렌더링이 강력하고 사실적 질감이 더 세밀
​
prompt
string
필수
이미지 생성을 위한 텍스트 설명, 최대 800자
​
size
string
기본값:"1:1"
이미지 가로세로 비율지원되는 가로세로 비율:
  • 1:1 - 정사각형 (기본값)
  • 4:3 - 가로 4:3
  • 3:4 - 세로 3:4
  • 16:9 - 가로 와이드스크린
  • 9:16 - 세로 전체화면
  • 3:2 - 가로 3:2
  • 2:3 - 세로 2:3
​
resolution
string
기본값:"1K"
해상도 등급
  • 1K - 표준 해상도 (기본값)
  • 2K - 고화질 해상도
​
n
integer
기본값:"1"
생성할 이미지 수범위: 1-6
​
negative_prompt
string
네거티브 프롬프트 (나타나지 않기를 원하는 콘텐츠), 최대 500자
​
image_urls
array
참조 이미지 URL 배열 (이미지-이미지 모드)제한:
  • 공개적으로 접근 가능한 URL이어야 함
  • Base64 형식은 지원되지 않음

​
해상도 대조표

size(비율) + resolution(해상도 등급) 조합으로 출력 크기를 제어합니다.
비율1K 등급2K 등급
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048
  • size만 전달 → 기본 1K 등급: {"size": "16:9"} → 1280×720
  • size + resolution 전달 → 지정 등급: {"size": "16:9", "resolution": "2K"} → 2048×1152

​
사용 예시

텍스트-이미지 (최소 요청) 
{
  "model": "qwen-image-2.0",
  "prompt": "햇살 아래 낮잠 자는 귀여운 주황색 고양이"
}
비율과 장수 지정 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "사이버펑크 스타일의 미래 도시 야경, 네온 불빛이 깜빡임",
  "size": "16:9",
  "n": 4
}
고화질 2K 등급 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "정교한 음식 사진, 초밥 모듬",
  "size": "4:3",
  "resolution": "2K",
  "n": 2
}
이미지-이미지 (참조 이미지 + 텍스트 설명) 
{
  "model": "qwen-image-2.0",
  "prompt": "배경을 해변 일몰로 변경",
  "image_urls": ["https://example.com/my-photo.jpg"]
}

​
Response

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

​
주의사항

  1. 비동기 처리: 제출 후 task_id가 반환됩니다. 결과를 얻으려면 /v1/tasks/{task_id}를 폴링하세요
  2. 이미지 저장: 생성된 이미지는 플랫폼 CDN에 미러링되어 장기간 유효합니다
  3. 과금 규칙: 성공적으로 생성된 이미지 수에 따라 과금, 실패 시 과금되지 않음
  4. 이미지 URL 요구사항: 입력 이미지는 공개적으로 접근 가능한 URL이어야 합니다, base64는 지원되지 않습니다