qwen_image_edit_spicy

이미지 편집 모델입니다. 공개 모델 ID는 qwen_image_edit_spicy, 기본 요금은 성공한 이미지당 $0.040입니다. APIMaster 요청에는 밑줄이 있는 이 ID를 사용합니다.

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.
image · string	필수 주 이미지. 접근 가능한 이미지 URL 또는 데이터 URI(data:image/png;base64,...).
reference_images · string[] | null = null; []	선택 문자열 배열. 추가 참조는 최대 2장, URL/데이터 URI 형식. 주 이미지를 포함해 총 3장까지.
images / image_urls · string[]	대체 순서 배열. 첫 이미지가 주 이미지, 나머지 최대 2장이 참조. 중복 방지를 위해 한 입력 방식만 사용.
seed · integer | null = null	선택 정수 또는 null, 기본값 null. 0 또는 null은 무작위 시드. 수치 범위는 공개되지 않았으므로 Z Image 범위를 적용하지 마세요.
size · string = auto	선택. auto만 허용. 출력 크기는 주 이미지를 따르며 width/height는 보내지 않음.
quality · standard; stream · false	미지원: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality는 생략하거나 standard 사용, 추가 품질 단계 없음. 알 수 없는 추가 매개변수는 거절됩니다.
resolution	Qwen은 주 이미지 1장과 참조 최대 2장. JSON은 image, images, image_urls, reference_images 순서로 합칩니다. image와 reference_images만 권장. prompt_extend와 명시 크기는 미지원, resolution 생략.

호출 예제

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": "qwen_image_edit_spicy",
  "prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
  "n": 1,
  "response_format": "url",
  "seed": 0,
  "image": "https://example.com/primary.png",
  "reference_images": [
    "https://example.com/reference.png"
  ]
}'

Python · requests

import os
import requests

api_base = "https://apimaster.ai/v1"
payload = {
    "model": "qwen_image_edit_spicy",
    "prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
    "n": 1,
    "response_format": "url",
    "seed": 0,
    "image": "https://example.com/primary.png",
    "reference_images": [
        "https://example.com/reference.png"
    ]
}
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)

cURL · multipart

multipart /images/edits는 image, 반복 image[] 또는 images로 파일을 전송합니다. 각 파일은 이미지이며 1바이트–10 MiB, 첫 파일이 주 이미지입니다. 동일 필드 방식을 사용하세요. multipart reference_images는 URL/데이터 URI 문자열의 JSON 배열입니다.

curl --max-time 750 'https://apimaster.ai/v1/images/edits' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -F 'model=qwen_image_edit_spicy' \
  -F 'prompt=Change the red paper boat to blue.' \
  -F 'n=1' \
  -F 'response_format=b64_json' \
  -F 'seed=0' \
  -F 'image[]=@primary.png' \
  -F 'image[]=@reference.png'

응답 및 과금

성공 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입니다.

qwen_image_edit_spicy

제한 및 문제 해결

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

Qwen은 주 이미지 1장과 참조 최대 2장. JSON은 image, images, image_urls, reference_images 순서로 합칩니다. image와 reference_images만 권장. prompt_extend와 명시 크기는 미지원, resolution 생략.

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

---

이미지 API 개요 · z-image-spicy-pro

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

MuleRouter API