APIMaster.ai

qwen_image_edit_spicy — Użycie i parametry

Edycja obrazu. Publiczny ID: qwen_image_edit_spicy; cena bazowa: $0.040 za udany obraz. W APIMaster używaj ID z podkreśleniami.

qwen_image_edit_spicy

Edycja obrazu. Publiczny ID: qwen_image_edit_spicy; cena bazowa: $0.040 za udany obraz. W APIMaster używaj ID z podkreśleniami.

Użyj klucza API APIMaster z Authorization: Bearer. JSON: Content-Type: application/json; granicę multipart ustawia cURL/requests. https://apimaster.ai/v1 już zawiera /v1.

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

Przykłady są synchroniczne: serwer czeka i odpytuje już przyjęte zadanie. Klient otrzymuje końcowy wynik Images, nie UUID dostawcy. Ustaw długi limit odczytu, np. 750 sekund; bez streamingu.

Parametry

Pole / typ Reguły i wartości domyślne
model · string Wymagane: dokładny publiczny ID powyżej.
prompt · string Wymagany niepusty tekst z opisem obrazu lub instrukcją edycji.
n · integer = 1 Opcjonalna liczba całkowita: tylko 1, domyślnie 1.
response_format · string = url Opcjonalny tekst: url (domyślnie) lub b64_json.
image · string Wymagany obraz główny: dostępny URL lub URI danych (data:image/png;base64,...).
reference_images · string[] | null = null; [] Opcjonalna tablica tekstów: maksymalnie dwa dodatkowe obrazy referencyjne w formacie URL/URI danych. Razem do trzech obrazów z głównym.
images / image_urls · string[] Alternatywna uporządkowana tablica: pierwszy obraz główny, do dwóch pozostałych referencyjnych. Używaj jednej konwencji, aby uniknąć duplikatów.
seed · integer | null = null Opcjonalna liczba całkowita lub null, domyślnie null; 0 lub null oznacza losowe ziarno. Zakres nie jest udokumentowany; nie stosuj zakresu Z Image.
size · string = auto Opcjonalnie, tylko auto. Wymiary wynikają z obrazu głównego; nie wysyłaj width/height.
quality · standard; stream · false Nieobsługiwane: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality pomiń lub ustaw standard, bez dodatkowego poziomu. Nieznane dodatkowe parametry są odrzucane.
resolution Qwen wymaga obrazu głównego i do dwóch referencji. JSON łączy image, images, image_urls, reference_images w tej kolejności; zalecane tylko image i reference_images. Bez prompt_extend i jawnych wymiarów; resolution pomiń.

Przykłady

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: pliki przez image, powtarzane image[] lub images. Każdy plik musi być obrazem od 1 bajta do 10 MiB; pierwszy jest główny. Używaj jednego pola. Multipart reference_images to tablica JSON tekstów URL/URI danych.

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'

Odpowiedzi i rozliczenia

HTTP 200 zawiera created (sekundy Unix) i jeden element data. url to adres pobierania, zapisz obraz szybko. b64_json to bajty base64. Sprawdź także zawartość obrazu.

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

Cena bazowa za obraz; istniejące mnożniki kanału, grupy i konta określają końcową opłatę w katalogu i logach. Obsługiwane rozmiary i referencje bez osobnej dopłaty; n=1.

qwen_image_edit_spicy

Ograniczenia i diagnostyka

Nieobsługiwane: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality pomiń lub ustaw standard, bez dodatkowego poziomu. Nieznane dodatkowe parametry są odrzucane.

Qwen wymaga obrazu głównego i do dwóch referencji. JSON łączy image, images, image_urls, reference_images w tej kolejności; zalecane tylko image i reference_images. Bez prompt_extend i jawnych wymiarów; resolution pomiń.

Przy 400 popraw parametry. Odmowy i awarie dostawcy zwracają błędy. Timeout, rozłączenie lub nieznane potwierdzenie nie dowodzą odmowy: zachowaj ID, sprawdź logi lub wsparcie przed kolejnym płatnym POST. Przyjęte zadania nie są automatycznie wysyłane ponownie.


Przegląd API obrazów · z-image-spicy-pro

Specyfikację sprawdzono 2026-10-30. Kontrakt opisuje wdrożony adapter APIMaster, a nie bezpośrednie API dostawcy.

MuleRouter API