저비용 텍스트-이미지 생성을 위한 Z-Image API

model: z-image를 사용하여 POST https://api.goenhance.ai/api/v1/images/generations를 통해 이미지를 생성하세요. Z-Image는 이미지당 $0.004(0.2 토큰)의 고정 비용이 발생하며(GoEnhance 이미지 카탈로그 중 최저가), 폴링 또는 콜백을 위한 비동기 img_uuid를 반환합니다.
API 키 생성
Z-Image 텍스트-이미지 생성을 나타내는 영화 같은 크리에이티브 스튜디오 장면

집중형 텍스트-이미지 API

프롬프트 우선 생성

이미지를 설명하려면 필수 prompt 필드(1~2000자)를 사용하세요. 현재 통합 엔드포인트는 model: z-image를 요구합니다.
상세한 프롬프트가 완성된 이미지로 변하는 과정을 보여주는 상상력이 풍부한 단일 장면 비주얼

이미지당 $0.004 고정 요금

모든 Z-Image 생성 비용은 0.2 토큰($0.004)입니다. 이 모델에는 해상도나 볼륨별 등급이 없으므로 비용 산정이 간편합니다.
효율적인 대규모 이미지 생성을 나타내는 세련된 단일 장면 프로덕션 설정
<code>z-image</code> 요청 스키마에서 지원하는 필드만 사용하세요.

Z-Image API 매개변수 및 기능

정확한 모델 ID

model을 정확히 z-image로 설정하세요. 페이지 제품명은 Z-Image로 유지됩니다.

필수 프롬프트

생성할 이미지를 설명하는 1~2000자 사이의 비어 있지 않은 prompt를 제공하세요.

7가지 화면 비율

1:1, 2:3, 3:2, 4:3, 3:4, 16:9, 9:16 중 하나를 정확히 선택하세요. ratio를 생략하면 모델 기본값이 사용됩니다.

선택적 콜백

처리, 성공 및 실패 업데이트를 받으려면 custom_callback_url을 공개 HTTPS 엔드포인트로 설정하세요.

텍스트-이미지 전용

이 경로는 참조 이미지나 편집 입력을 허용하지 않습니다. 참조 기반 편집이 필요한 워크플로우에는 다른 GoEnhance 이미지 모델을 사용하세요.

스키마 유효성 검사

지원되지 않는 비율은 토큰이 차감되기 전 스키마 유효성 검사 단계에서 거부됩니다. Z-Image에는 auto 또는 21:9 비율이 없습니다.
단일 요금 체계로 저렴한 AI 이미지 생성 API 예산을 쉽게 계산할 수 있습니다.

간편하고 일관된 Z-Image 요금제

이미지당 $0.004

성공적인 각 생성 비용은 이미지당 정확히 $0.004입니다.

이미지당 0.2 토큰

동일한 비용은 0.2 토큰입니다. GoEnhance 토큰은 500토큰당 $10, 즉 토큰당 $0.02로 책정됩니다.

해상도 또는 볼륨 등급 없음

Z-Image는 이미지당 단일 고정 요금제를 제공합니다. 요청 시 해상도 매개변수를 노출하지 않으며, 게시된 요금은 볼륨에 따라 변경되지 않습니다.

3단계로 Z-Image 통합하기

1

1. 프롬프트 제출

{"model":"z-image","prompt":"...","ratio":"16:9"}와 함께 https://api.goenhance.ai/api/v1/images/generations로 인증된 POST 요청을 보냅니다.
2

2. img_uuid 저장

제출이 성공하면 data.img_uuid가 반환됩니다. 이미지가 생성될 때까지 동기적으로 기다리지 말고 애플리케이션 기록에 해당 ID를 저장하세요.
3

3. 폴링 또는 콜백 수신

GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=...를 폴링하거나 custom_callback_url을 등록하여 처리, 성공, 실패 상태를 관리하세요.
API 키 생성
예측 가능한 이미지당 비용과 간결한 요청 형식이 중요한 곳에 Z-Image를 사용하세요.

저비용 텍스트-이미지 API가 적합한 경우

콘텐츠 일러스트레이션

텍스트 프롬프트로 기사, 가이드, 편집 워크플로우를 위한 시각적 콘셉트를 생성하세요.

제품 콘셉트 기획

생산 전 제품, 패키징, 환경 또는 캠페인 테마에 대한 초기 시각적 방향을 설정하세요.

광고 크리에이티브 탐색

이미지당 고정 비용을 유지하면서 크리에이티브 검토를 위한 독창적인 프롬프트 기반 콘셉트를 제작하세요.

현지화된 시각적 파이프라인

지원되는 가로, 세로 또는 정사각형 비율을 선택하면서 지역별 테마와 형식에 맞게 프롬프트를 조정하세요.

배경 생성

참조 편집이 필요 없는 후속 디자인 워크플로우를 위해 장면 배경 및 분위기 에셋을 생성하세요.

대량 프로토타이핑

해상도나 볼륨 등급 계산 없이 $0.004의 고정 요금으로 프로토타입 생성 비용을 산정하세요.
저비용 텍스트-이미지 변환 API를 평가하는 개발자를 위한 통합 세부 정보.

Z-Image API 자주 묻는 질문

Z-Image API에는 어떤 엔드포인트를 사용해야 하나요?

POST https://api.goenhance.ai/api/v1/images/generations를 사용하고 model을 z-image로 설정하세요. 레거시 POST /api/v1/z-image 경로도 존재하지만, 통합 이미지 엔드포인트가 현재 문서화된 통합 경로입니다.

일부 검색에서 Turbo라는 이름을 사용하는 이유는 무엇인가요?

Alibaba/Tongyi는 업스트림 모델을 Z-Image Turbo로 지칭합니다. GoEnhance 카탈로그 및 API 문서에서 제품명은 Z-Image이며 정확한 모델 ID는 z-image입니다.

Z-Image 생성 비용은 얼마인가요?

이미지당 $0.004(0.2 토큰)의 고정 요금이 적용됩니다. 이 모델에는 해상도 등급이나 볼륨 등급이 없습니다.

Z-Image는 어떤 비율을 지원하나요?

1:1, 2:3, 3:2, 4:3, 3:4, 16:9, 9:16 등 총 7가지를 지원합니다. 해당 경로는 auto나 21:9를 허용하지 않습니다.

참조 이미지를 보내거나 기존 이미지를 편집할 수 있나요?

아니요. 이 경로의 Z-Image는 텍스트-이미지 전용이며 참조 이미지, 이미지-이미지 입력 또는 편집 요청을 허용하지 않습니다. 참조 기반 편집을 위해서는 다른 GoEnhance 모델을 선택하세요.

한 번의 호출로 해상도를 지정하거나 여러 이미지를 요청할 수 있나요?

아니요. Z-Image 스키마에는 해상도 필드나 n 또는 배치 카운트 매개변수가 없습니다. 여러 결과물이 필요한 경우 별도의 생성 요청을 제출하세요.

비동기 Z-Image 작업은 어떻게 완료되나요?

생성 응답으로 img_uuid가 반환됩니다. /api/v1/jobs/detail?img_uuid=...를 폴링하거나 custom_callback_url을 제공하여 상태 변경을 수신하세요.

GoEnhance는 Alibaba와 제휴 관계인가요?

아니요. Z-Image는 알리바바의 통이(Tongyi)/큐원(Qwen) 조직에서 시작되었습니다. GoEnhance 오픈 API는 독립적인 제3자 플랫폼이며 알리바바와 제휴하거나 보증을 받지 않았습니다.

Z-Image API로 개발 시작하기