z-image-spicy-pro

텍스트로 이미지를 생성합니다. 공개 모델 ID는 z-image-spicy-pro, 기본 요금은 성공한 이미지당 $0.020입니다.

APIMaster API 키를 Authorization: Bearer로 전송합니다. JSON은 Content-Type: application/json, multipart boundary는 cURL/requests가 설정하도록 합니다. https://apimaster.ai/v1는 이미 /v1을 포함합니다.

POST https://apimaster.ai/v1/images/generations · application/json

예제는 동기 엔드포인트입니다. 서버는 접수된 공급자 작업을 조회하며 기다리고 최종 Images 결과를 반환합니다. 공급자 UUID를 반환하지 않습니다. 읽기 제한은 750초처럼 충분히 길게 설정하며 스트리밍은 사용하지 않습니다.

매개변수

필드 / 유형	규칙 및 기본값
model · string	필수. 위의 정확한 공개 모델 ID.
prompt · string	필수인 비어 있지 않은 문자열. 이미지 설명 또는 편집 지시.
n · integer = 1	선택 정수. 1만 지원, 기본값 1.
response_format · string = url	선택 문자열. url(기본값) 또는 b64_json.
width / height · integer = 1024	선택 정수. 너비와 높이 각각 256–2560픽셀. 공급자 기본값 1024 × 1024.
size · string	선택 너비x높이(예: 512x512) 또는 auto. 명시한 width/height와 일치해야 하며 모든 크기를 생략하면 공급자 기본값 사용.
seed · integer | null = 0	선택 정수 또는 null. 0–2147483647, 기본값 0. 0 또는 null은 무작위 시드이며 재현성을 보장하지 않음.
prompt_extend · boolean | null = false	선택 불리언 또는 null. 기본값 false. true는 공급자 프롬프트 재작성·확장을 활성화하고 null은 기본 동작 사용.
quality · standard; stream · false	미지원: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality는 생략하거나 standard 사용, 추가 품질 단계 없음. 알 수 없는 추가 매개변수는 거절됩니다.
resolution	Z Image는 참조 이미지 미지원. size 또는 width/height를 사용하고 resolution은 생략합니다(기존 1K는 허용하지만 크기를 지정하지 않음).

호출 예제

cURL · JSON

curl --max-time 750 'https://apimaster.ai/v1/images/generations' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "z-image-spicy-pro",
  "prompt": "A red paper boat on a calm blue pond, no text.",
  "n": 1,
  "response_format": "url",
  "seed": 0,
  "width": 512,
  "height": 512,
  "prompt_extend": false
}'

Python · requests

import os
import requests

api_base = "https://apimaster.ai/v1"
payload = {
    "model": "z-image-spicy-pro",
    "prompt": "A red paper boat on a calm blue pond, no text.",
    "n": 1,
    "response_format": "url",
    "seed": 0,
    "width": 512,
    "height": 512,
    "prompt_extend": False
}
response = requests.post(
    api_base + "/images/generations",
    headers={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
    json=payload,
    timeout=(20, 750),
)
response.raise_for_status()
result = response.json()
print(result)

응답 및 과금

성공 HTTP 200에는 created(Unix 초)와 항목 하나인 data가 있습니다. url은 다운로드 주소이므로 신속히 저장하세요. b64_json은 이미지 바이트의 base64입니다. 상태 코드와 이미지 내용을 함께 확인합니다.

{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}

{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}

기본 요금은 이미지당이며 기존 채널·그룹·계정 배율이 적용됩니다. 최종 차감은 모델 광장과 사용 로그에서 확인합니다. 지원 크기와 참조 수에 별도 추가 요금은 없습니다. 예제는 n=1입니다.

z-image-spicy-pro

제한 및 문제 해결

미지원: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality는 생략하거나 standard 사용, 추가 품질 단계 없음. 알 수 없는 추가 매개변수는 거절됩니다.

Z Image는 참조 이미지 미지원. size 또는 width/height를 사용하고 resolution은 생략합니다(기존 1K는 허용하지만 크기를 지정하지 않음).

400이면 매개변수를 수정합니다. 공급자 거절·실패는 오류로 반환됩니다. 타임아웃·연결 끊김·접수 불명은 미생성 증거가 아닙니다. 요청 ID를 보관하고 로그 또는 지원을 확인한 후 새 유료 POST 여부를 판단하세요. 접수 작업을 자동 재전송하지 않습니다.

---

이미지 API 개요 · qwen_image_edit_spicy

공급자 사양 확인일: 2026-10-30. 본 계약은 배포된 APIMaster 어댑터를 설명하며 공급자 생성·조회 API를 그대로 사용하지 않습니다.

MuleRouter API