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.
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.
