Skip to main content
POST

지원되는 모델

인증

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

Body

string
필수
모델 이름
  • z-image-turbo - 경량 고속 이미지 생성, 중국어와 영어 지원
string
필수
이미지 생성을 위한 텍스트 설명, 최대 800자
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
string
기본값:"1K"
해상도 등급
  • 1K - 표준 해상도 (기본값)
  • 2K - 고화질 해상도
boolean
기본값:"false"
스마트 프롬프트 재작성활성화하면 AI가 자동으로 프롬프트를 최적화하여 더 나은 결과를 생성하고, 비용이 증가합니다.
  • false - 비활성화 (기본값)
  • true - 활성화

해상도 대조표

size(비율) + resolution(해상도 등급) 조합으로 출력 크기를 제어합니다.

사용 예시

기본 텍스트-이미지 (최소 요청)
비율과 해상도 지정
스마트 프롬프트 재작성 활성화

Response

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

주의사항

  1. 비동기 처리: 제출 후 task_id가 반환됩니다. 결과를 얻으려면 /v1/tasks/{task_id}를 폴링하세요
  2. 이미지 저장: 생성된 이미지는 플랫폼 CDN에 미러링되어 장기간 유효합니다
  3. 과금 규칙: 성공적으로 생성된 이미지 수에 따라 과금, 실패 시 과금되지 않음
  4. 고정 장수: Z-Image-Turbo는 요청당 고정 1장 생성, n 파라미터는 지원되지 않음