Jak korzystać z Qwen Image 3.0 API: generowanie, edycja i cennik

TL;DR

Qwen Image 3.0 łączy generowanie obrazów z tekstu oraz edycję prowadzoną na podstawie referencji w wariantach Standard (qwen-image-3.0) i Pro (qwen-image-3.0-pro). Zacznij od promptu tekstowego, wybierz rozmiar wyjściowy, wyślij żądanie generowania obrazu i niezwłocznie zapisz wynik. Do edycji dołącz od jednego do trzech obrazów referencyjnych oraz jednoznaczną instrukcję zachowania. W CometAPI przed wdrożeniem przykładowych wywołań zweryfikuj rzeczywisty endpoint i kompatybilny schemat żądania.

Najważniejsze informacje

• API Qwen Image 3.0 obsługuje generowanie obrazów z tekstu oraz edycję z wykorzystaniem obrazów referencyjnych w wariantach Standard (qwen-image-3.0) i Pro (qwen-image-3.0-pro); natywny format wyjściowy to PNG.
• Dostęp do Qwen Image 3.0 API jest dostępny przez CometAPI. Deweloperzy mogą uzyskać klucz API, zweryfikować obsługiwany endpoint i zintegrować generowanie obrazów w swoich aplikacjach.
• Cennik Qwen Image 3.0 API w CometAPI zaczyna się od $0.024/żądanie, podczas gdy stawki Alibaba Cloud Singapore zaczynają się od $0.030 za obraz wyjściowy w wariancie Standard oraz $0.040 za obraz wyjściowy Pro 1K.
• Edycja obrazu w Qwen Image 3.0 obsługuje do trzech obrazów referencyjnych przez natywne API Alibaba Cloud, a generowanie obsługuje od jednego do sześciu wyników na żądanie.
• Integracja Qwen Image 3.0 API wymaga weryfikacji parametrów specyficznych dla dostawcy, uwierzytelniania, jednostek rozliczeniowych oraz tymczasowych adresów URL obrazów przed wdrożeniem produkcyjnym.

Czym jest Qwen Image 3.0 API?

Qwen Image 3.0 API zamienia instrukcje tekstowe na obrazy i potrafi przekształcać dostarczone fotografie lub zasoby projektowe. Obsługiwane scenariusze obejmują wielojęzyczne plakaty, fotografię e-commerce, makiety kampanii, podmianę tła oraz edycję obrazów złożonych.

Qwen Image 3.0 Standard (qwen-image-3.0) to wariant skoncentrowany na kosztach dla generowania z tekstu oraz edycji z referencjami. Rozważ go w pierwszej kolejności dla przepływów o dużej skali, takich jak odmiany tła w e-commerce, robocze wizualizacje do social mediów i eksploracja koncepcji kampanii. Na przykład użyj Standard do wygenerowania kilku wariantów tła dla produktu, następnie oceń zgodność z produktem i wybierz wersje warte dopracowania.

Qwen Image 3.0 Pro (qwen-image-3.0-pro) obsługuje generowanie i edycję z referencjami, oferując droższy natywny poziom wyjścia 2K. Oceń go pod kątem rezultatów wymagających wysokiej jakości, takich jak obrazy „hero” kampanii, szczegółowe kompozycje produktowe i plakaty promocyjne. Na przykład przetestuj wyselekcjonowaną koncepcję w Pro, gdy liczą się detale lub układ, i porównaj zaakceptowane rezultaty ze Standard przed podjęciem decyzji o większym budżecie.

Jak wybrać: Zacznij od Standard do wersji roboczych i wariantów wrażliwych na koszt. Przetestuj Pro na tym samym briefie dla wymagających zasobów końcowych; wybierz go, gdy mierzalna poprawa uzasadnia dodatkowy koszt. Żaden z wariantów nie zastępuje testów specyficznych dla aplikacji w zakresie typografii, wierności produktu, liczby obiektów czy dokładności układu.

Jakie parametry obsługuje Qwen Image 3.0 API?

Używaj tych parametrów z natywnym interfejsem Alibaba Cloud kompatybilnym z OpenAI. Dodawaj opcje specyficzne dla dostawcy do żądań CometAPI tylko wtedy, gdy wybrany route je dokumentuje.

Dotyczy obu wariantów: qwen-image-3.0 (Standard) i qwen-image-3.0-pro (Pro) obsługują te same parametry wymienione poniżej w natywnym interfejsie Alibaba Cloud kompatybilnym z OpenAI. Wybierz wariant poprzez model; sterowanie generowaniem i edycją jest wspólne. Nie implikuje to identycznej jakości wyjścia ani cen, ani nie gwarantuje, że każdy route CometAPI udostępnia wszystkie natywne parametry.

Dla natywnych żądań proporcje obrazu muszą mieścić się między 1:8 a 8:1. Obrazy referencyjne muszą mieć maksymalnie 10 MB, każdy bok między 1 a 8 000 pikseli i stosunek najdłuższego do najkrótszego boku nie większy niż 10:1. Dla wejścia Base64 użyj URI danych. Thinking wymaga prompt_extend=true; ulepszenie agent obsługuje tylko generowanie z tekstu.

Kompatybilne żądanie obrazowe umieszcza pola generowania na najwyższym poziomie JSON i zapisuje wymiary jako 1024x1024. Natywny DashScope używa zagnieżdżonych input/parameters i często zapisuje wymiary jako 1024*1024. Skopiowanie żądania między tymi endpointami bez konwersji może zakończyć się błędem.

Jak wywołać Qwen Image 3.0 API przez CometAPI?

Ten przewodnik zakłada Python 3, terminal zgodny z Bash, konto CometAPI z dostępem do modelu i wystarczającym saldem. Pierwsze żądanie używa wyłącznie pól model i prompt pokazanych w przykładzie dostawcy. Dokumentacja sprawdzona 16 października 2026; te przykłady nie zostały wykonane na płatnym koncie.

Utwórz dane uwierzytelniające

Utwórz serwerowy klucz API w panelu CometAPI. Nigdy nie umieszczaj go w aplikacji webowej ani mobilnej.

export COMETAPI_KEY="your_api_key"python -m pip install requests

Wyślij minimalne żądanie generowania

Deweloperzy mają dostęp do Qwen Image 3.0 API w CometAPI, używając udokumentowanego endpointu do generowania obrazów. Zacznij od minimalnego żądania poniżej, zanim dodasz parametry opcjonalne.

curl --fail-with-body https://api.cometapi.com/v1/images/generations \  -H "Authorization: Bearer $COMETAPI_KEY" \  -H "Content-Type: application/json" \  -d '{"model":"qwen-image-3.0","prompt":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'

Zapisz każdy zwrócony obraz

Zapisz poniższy skrypt jako generate.py i uruchom python generate.py. Wysyła on żądanie, obsługuje wyniki typu URL lub Base64 i zapisuje każdy obraz lokalnie. Jeśli odpowiedź zawiera informacje o zadaniu zamiast tablicy data, skrypt zatrzymuje się zamiast zgadywać endpoint do odpytywania; użyj właściwego asynchronicznego kontraktu konta, aby pobrać ukończony wynik.

import base64import osfrom pathlib import Pathimport requests​response = requests.post(    "https://api.cometapi.com/v1/images/generations",    headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"},    json={"model": "qwen-image-3.0", "prompt": "A sunny bookstore cafe, editorial photograph"},    timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images:    raise RuntimeError(f"No synchronous images; inspect task/error fields: {list(result)}")for index, item in enumerate(images, 1):    if item.get("url"):        download = requests.get(item["url"], timeout=(15, 120))        download.raise_for_status()        content = download.content    elif item.get("b64_json"):        content = base64.b64decode(item["b64_json"], validate=True)    else:        raise RuntimeError(f"Image {index} has no URL or Base64 payload")    path = Path(f"qwen_image_{index}.png")    path.write_bytes(content)    print(f"Saved {path}")

Pomyślne uruchomienie tworzy lokalne pliki obrazów. Otwórz je, aby potwierdzić, że są czytelne i odpowiadają żądanej scenie. Zachowaj identyfikator żądania i pola usage w logach serwera, bez logowania danych uwierzytelniających.

Jak wygenerować wiele obrazów w Qwen Image 3.0?

W natywnym interfejsie Alibaba Cloud ustaw n na wartości od dwóch do sześciu, aby uzyskać wariacje kreatywne. W CometAPI włącz n dopiero po potwierdzeniu wsparcia na wybranym endpointzie. Waliduj każdy zwrócony zasób osobno; większa wartość n nie gwarantuje, że każdy wynik przejdzie dalszą kontrolę jakości.

Możesz wygenerować do 6 obrazów w jednym żądaniu z Qwen Image 3.0, ustawiając parametr n. Działa to zarówno z qwen-image-3.0, jak i qwen-image-3.0-pro, dla generowania z tekstu i edycji obrazów. Domyślnie generowany jest tylko jeden obraz.

Są dwa główne sposoby: użyj interfejsu graficznego, jeśli Twoja platforma udostępnia taką opcję, lub wywołaj API bezpośrednio.

Generuj wiele obrazów przez API

1. Otwórz dokumentację API.
2. Uzyskaj klucz API z konsoli QwenCloud / CometAPI.
3. Wybierz qwen-image-3.0 lub qwen-image-3.0-pro.
4. Ustaw n na liczbę żądanych obrazów od 1 do 6.
5. Wyślij prompt i zapisz zwrócone obrazy.

Na przykład ustaw "n": 4, aby poprosić o cztery warianty tego samego promptu.

Przykład w Pythonie

Poniżej gotowy do adaptacji przykład korzystający z API kompatybilnego z OpenAI.

from openai import OpenAIimport requestsclient = OpenAI(    api_key="YOUR_QWEN_API_KEY",    base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate(    model="qwen-image-3.0-pro",    
prompt=(        "A cozy Japanese cafe on a rainy evening, "        "warm glowing lights, cinematic photography, "        "rich details, realistic reflections"    ),    
n=4,    
size="1024x1024")# Save each generated image
for i, item in enumerate(result.data, start=1):    response = requests.get(item.url)    response.raise_for_status()    with open(f"qwen_image_{i}.png", "wb") 
as f:        
f.write(response.content)print("Finished generating images!")

Zainstaluj najpierw wymagane pakiety:

pip install openai requests

API zwraca adres URL obrazu dla każdego wyniku. Adresy URL wygenerowanych obrazów są tymczasowe, więc pobierz obrazy niezwłocznie.

Ważne ustawienia

Maksymalna liczba wyników to sześć na żądanie. Pamiętaj, że prosząc o więcej obrazów, zwiększasz koszt generowania.

Ważne rozróżnienie: n=4 żąda czterech wariacji jednego promptu. Jeśli chcesz cztery różne prompty, wykonaj osobne żądania lub zautomatyzuj pętlę po promptach.

Jak edytować obrazy w Qwen Image 3.0?

Edycja łączy od jednego do trzech obrazów referencyjnych z instrukcjami. Wyjaśnij zarówno pożądane przekształcenie, jak i to, co nie może się zmienić — na przykład etykieta produktu, kolor, kąt kamery lub geometria opakowania.

Kolejny przykład używa danych uwierzytelniających Alibaba Cloud i jego pola obrazu JSON do edycji. Utwórz regionalny klucz Model Studio, uzyskaj ID przestrzeni roboczej i skonfiguruj dopasowany endpoint. Nie podstawiaj klucza CometAPI w tym żądaniu.

export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"

Poniższy obraz referencyjny pochodzi bezpośrednio z oficjalnego przykładu API. Jest to obraz wejściowy, a nie wynik wygenerowany w tym artykule.

import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]  
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0", 
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.", 
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"], 
"size": "1024x1024", 
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())

Natywny kompatybilny endpoint używa JSON na /images/generations, a nie przesyłania multipart na /images/edits. Nie obsługuje masek ani streamingu. Odczytaj zwróconą tablicę data i zapisz każdy adres URL, używając tej samej pętli pobierania pokazanej powyżej.

Dla dwóch referencji umieść dwa adresy URL w tablicy image i określ ich role w promptcie (np. produkt z obrazu pierwszego, aranżacja pomieszczenia z obrazu drugiego). Seria Qwen Image 3.0 akceptuje maksymalnie trzy obrazy referencyjne; użyj innego modelu lub workflowu wstępnego przetwarzania dla większych zestawów źródeł.

Ile kosztuje Qwen Image 3.0 API?

Ceny Qwen Image 3.0 API różnią się w zależności od wariantu modelu, rozdzielczości wyjścia i dostawcy. Poniższa tabela uzupełnia oryginalne porównanie Alibaba Cloud Singapore o stawki CometAPI z załączonej przez recenzenta tabeli cen. Załącznik podaje ceny wyjścia w USD za obraz oraz 20% zniżki dla wszystkich czterech kombinacji model/rozdzielczość. Te dostarczone stawki nie zostały niezależnie zweryfikowane względem rozliczeń na żywym koncie; potwierdź obowiązujący cennik przed użyciem produkcyjnym.

*Powyższe przykłady wolumenów obejmują tylko obrazy wyjściowe: 100 obrazów Standard 1K kosztuje $2.40, a 100 obrazów Pro 1K kosztuje $3.20; 1 000 obrazów Standard 2K kosztuje $24.00, a 1 000 obrazów Pro 2K kosztuje $60.00. Dla edycji dodaj $0.0024 za każdy rozliczalny obraz referencyjny wejściowy. Zasady dotyczące nieudanych zadań, podatki i korekty specyficzne dla konta są wyłączone.

Używając dostarczonych stawek za obrazy wejściowe i wyjściowe, oszacuj opłaty za obrazy dla dowolnego dostawcy w następujący sposób:

Total cost = (billable reference images × input-image price) + (successful outputs × output-image price).

Dla zadania rozliczanego za dwa obrazy referencyjne wejściowe i trzy pomyślne wyjścia Standard 1K, opłaty za obrazy w Alibaba Cloud wynoszą (2 × $0.0030) + (3 × $0.0300) = $0.0960. Odpowiednie opłaty za obrazy w CometAPI to (2 × $0.0024) + (3 × $0.0240) = $0.0768, na podstawie dostarczonych stawek.

CometAPI pobiera $0.0024 za każdy obraz referencyjny wejściowy dla obu wariantów. Ceny wyjściowe to $0.0240 za obraz Standard przy 1K lub 2K, $0.0320 za obraz Pro przy 1K i $0.0600 za obraz Pro przy 2K. Dostarczona tabela podaje każdą stawkę wejściową i wyjściową o 20% niższą od odpowiadającej jej oficjalnej ceny. Dla tej samej liczby rozliczalnych obrazów opłaty obrazowe są więc o 20% niższe; dodatkowe opłaty lub warunki konta mogą zmienić finalną fakturę.

Przy budżetowaniu produkcyjnym zweryfikuj wybrany wariant, rozdzielczość obrazów, opłaty za obrazy referencyjne, liczbę wyników na żądanie oraz obowiązujące zniżki konta przed oszacowaniem całkowitych kosztów użycia.

Jak obsługiwać błędy Qwen Image 3.0 API?

FAQ

Czy powinienem ponawiać żądanie Qwen Image 3.0 po przekroczeniu limitu czasu?

Przekroczenie limitu czasu po stronie klienta nie dowodzi, że generowanie się zatrzymało. Zachowaj identyfikator żądania lub zadania, sprawdź historię zadań u dostawcy lub udokumentowane API statusu i ustal, czy wynik już istnieje przed ponownym wysłaniem. Ślepe ponowienia mogą tworzyć zduplikowane zadania i dodatkowe koszty. Stosuj ograniczone ponawianie dla błędów przejściowych i przestrzegaj wytycznych dotyczących idempotencji, jeśli są dostępne.

Jak użyć lokalnych obrazów referencyjnych z Qwen Image 3.0?

W natywnym interfejsie kompatybilnym zakoduj plik bajtowo w Base64 i poprzedź go URI danych, np. data:image/png;base64,. Umieść ten kompletny ciąg w image. Wejście Base64 nadal musi spełniać limity rozmiaru obrazu i wymiarów; ścieżka lokalna nie jest adresem URL, który usługa może pobrać.

Jak przekazać opcje specyficzne dla Qwen przez SDK OpenAI?

Utrzymaj standardowe pola obrazu w zwykłych argumentach SDK, a rozszerzenia Model Studio, takie jak image i prompt_extend, umieść w extra_body. Surowe żądania HTTP umieszczają te pola bezpośrednio na najwyższym poziomie JSON. Ta wskazówka dotyczy natywnego interfejsu kompatybilnego; sprawdź wybrany route CometAPI przed przekazaniem opcji specyficznych dla dostawcy.

Co zrobić, gdy Qwen Image 3.0 zwróci mniej obrazów niż zażądano?

Najpierw zapisz pomyślne wyniki i zanotuj rzeczywistą liczbę. W natywnym rozliczaniu Alibaba Cloud opłaty za wyjścia dotyczą pomyślnie wygenerowanych obrazów. Jeśli potrzebujesz dodatkowych zasobów, poproś tylko o brakującą ilość po sprawdzeniu odpowiedzi i rejestru użycia; rozliczenia CometAPI należy uzgadniać zgodnie z warunkami danego konta.

Zakończenie

Qwen Image 3.0 to praktyczny wybór dla zespołów potrzebujących generowania i edycji sterowanej referencjami w jednej rodzinie modeli. Używaj Standard jako wariantu zorientowanego na koszty, testuj Pro dla bardziej wymagających zadań 2K lub kreatywnych i mierz koszt zaakceptowanych wyników zamiast oceniać po cenie per żądanie. Zacznij od minimalnego wywołania generowania, zachowaj jego wyniki, a następnie dodaj edycję lub wiele wyjść zgodnie z odpowiednim kontraktem dostawcy. Oddzielaj dane uwierzytelniające i schematy żądań, explicite obsługuj błędy i uzgadniaj użycie obrazów z wybranym cennikiem.