Skip to main content
POST

Authorizations

string
필수
모든 인터페이스는 Bearer Token으로 인증해야 합니다.API Key 받기:API Key 관리 페이지에 방문하여 API Key를 받으세요.사용할 때는 요청 헤더에 다음을 추가하세요:

Body

string
필수
모델 이름.고정값: "z_image_turbo"
object
필수
모델 파라미터 객체.
string
필수
호출 측에서 지정하는 사용자 정의 작업 ID로, 멱등 제출 및 결과 조회에 사용됩니다.
  • 길이는 1-64자
  • 영문자, 숫자, 밑줄, 하이픈만 허용됩니다
  • 동일한 API Key 아래에서는 중복 사용할 수 없습니다
Z-Image Turbo는 텍스트로 이미지 생성만 지원합니다. 참고 이미지(image_url), 이미지 편집, 해상도 단계(resolution), 일괄 이미지 생성(output_n)은 모두 지원되지 않으며, 사용자 지정 픽셀 크기 size를 전달하면 즉시 Model "z_image_turbo" does not support size parameter를 반환합니다. 요청마다 항상 1장의 이미지만 반환되므로, 여러 장이 필요하면 서로 다른 seed로 여러 번 제출하세요.참고 이미지, 이미지 기반 이미지 생성 또는 더 큰 캔버스가 필요할 때는 GPT-Image 2, Seedream 5.0 Pro 또는 Nano Banana Pro를 사용하세요.

Response

string
호출자 작업 ID로, 결과 조회에 사용할 수 있습니다.
string
초기 상태이며, 고정값은 "pending"입니다.
number
이번 작업의 예상 소모 크레딧입니다.
string
생성 시간, ISO 8601 형식입니다.

조회 결과

제출이 성공한 후, 동일한 out_task_id를 사용하여 호출합니다:
작업 상태에는 pending, processing, completed, failed가 포함됩니다. 작업이 완료되면 결과 이미지는 data.output에 있으며, 실제 소모량은 data.credits_used에 있습니다. 작업 생성에 실패하면 시스템이 이번 작업의 사전 차감 크레딧을 자동으로 환불합니다.