Z-Image API: 가격, 파라미터, 코드

Name: Z-Image API
SKU: alibaba/z-image-turbo/text-to-image
Price: 0.02 USD
Availability: InStock

요청 파라미터

파라미터	필수	설명
`seed`	아니요	같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647
`prompt`	예	Describe the image to generate: subject, composition, style, and lighting.
`aspect_ratio`	아니요	화면 모양: 가로, 정사각형, 세로. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 기본값: 1:1
`output_format`	아니요	결과 파일 형식. png · 기본값: png
`enable_prompt_expansion`	아니요	짧은 프롬프트에 모델이 디테일을 덧붙입니다. 기본값: false

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션	크레딧 /장	≈ USD
기본	1.5	US$0.015
enable_prompt_expansion true	2.4	US$0.024

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 2크레딧/장(US$0.02)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Z-Image API를 3단계로 호출하기

API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
요청 보내기. POST /jobs/createTask에 model은 alibaba/z-image-turbo/text-to-image, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/z-image-turbo/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Z-Image API 질문

Z-Image API 요금은 얼마인가요?

Z-Image 가격은 2크레딧(US$0.02) /장입니다. 옵션별 가격: 기본 1.5크레딧/장, true 2.4크레딧/장. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Z-Image의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 이미지 만들기: alibaba/z-image-turbo/text-to-image을(를) 넣으세요.

Z-Image는 실제로 얼마나 빠른가요?

text-to-image 프레임 하나에 1초 안팎입니다. 이게 이 패밀리의 핵심입니다. 반복이 충분히 짧아서 문장을 결단이 아니라 실험으로 다룰 수 있습니다.

aspect_ratio는 정확히 뭘 조절하나요?

출력 픽셀 크기입니다. 각 비율이 모델의 네이티브 100만 화소 근처 고정 크기로 이어지기 때문에, 극단적인 비율에서 무너지지 않고 품질이 고르게 유지됩니다.

예전에 만든 이미지를 그대로 다시 뽑을 수 있나요?

seed를 남겨 두었다면 거의 비슷하게 됩니다. 같은 프롬프트, 같은 화면비, 같은 seed면 예전 프레임에 아주 가깝게 나오지만 픽셀 단위로 같다는 보장은 없습니다. seed가 없으면 같은 요청도 매번 다른 프레임을 돌려주니, 남기고 싶은 결과물 옆에 프롬프트와 seed를 함께 보관해 두세요.