Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro to flagowy model Qwen do generowania i edycji obrazów, do złożonych układów, realistycznych szczegółów i wielojęzycznego tekstu. Użyj precyzyjnego opisu lub od jednego do trzech materiałów referencyjnych, aby stworzyć grafikę, scenę produktu lub konkretną edycję wizualną.

Ailoot Ultra · Obrazy POST /v1/images/generations qwen/qwen-image-3-pro

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

Qwen-Image-3.0 Pro to flagowy model Qwen trzeciej generacji do tworzenia i edycji obrazów. Łączy tworzenie złożonych układów, szczegółowe realistyczne tekstury, wielojęzyczną typografię i ścisłe wykonywanie opisu obrazu. Pro i standardowy Qwen-Image-3.0 dzielą udokumentowane tryby generowania i edycji; Pro kładzie nacisk na jakość obrazu, a standardowe wydanie równoważy jakość i szybkość. Wynikiem jest wyrenderowany obraz.

W grafice bogatej w informacje zdefiniuj treść przed wyglądem: nagłówek, tekst pomocniczy, liczby, hierarchię i relacje między sekcjami. Przydatny opis produktu może łączyć główny obiekt, zbliżenia szczegółów materiału i opisane cechy na jednym obszarze roboczym. W ilustracji edukacyjnej określ pojęcie, strukturę diagramu i dokładne podpisy zamiast liczyć, że model wymyśli podstawowe fakty. Złożone układy mogą również pokazywać kilka paneli lub zagnieżdżone interfejsy. Zalecany maksymalny prompt, 4 500 tokenów, skoncentruj na tym, co musi się pojawić i gdzie należy to umieścić.

Rodzina 3.0 obsługuje natywną typografię w 12 językach, wiele fontów i ponad 100 stylów artystycznych oraz drobne tekstury, takie jak włosy, skóra czy tkanina. Demonstrowane jest renderowanie drobnego tekstu nawet przy rozmiarze 10 pikseli. Wspiera to projekt łączący liternictwo z fizycznym materiałem albo tekst z realistycznym obrazem. Podaj dokładne brzmienie, cyfry i język oraz opisz typograficzną rolę każdego bloku. Strona gazety lub makieta interfejsu nadal jest obrazem, więc późniejszy edytowalny układ lub interaktywne działanie to osobny rezultat, który trzeba na jej podstawie zbudować.

Pro może edytować tekst wewnątrz obrazu, dodawać, usuwać lub przesuwać elementy, zmieniać działanie przedstawionego podmiotu, przenosić styl wizualny i ulepszać szczegóły. Edycja przyjmuje od jednego do trzech obrazów wejściowych z instrukcją. Ich kolejność wyznacza obraz 1, obraz 2 i obraz 3 w opisie. Określ, który materiał referencyjny dostarcza tożsamość podmiotu, który obiekt lub ubranie, a który otoczenie lub pozę. Konkretna edycja wskazuje zarówno zamierzoną zmianę, jak i cechy, które mają pozostać nienaruszone, co ułatwia porównanie wyniku z referencjami.

Obsługiwane wejścia to JPG, JPEG, PNG, BMP, TIFF, WebP i GIF; w animowanych GIF-ach używana jest tylko pierwsza klatka. Każdy obraz wejściowy może mieć do 10 MB. Dokładne API dopuszcza boki od 1 do 8 000 pikseli i stosunek dłuższego boku do krótszego nie większy niż 10:1; zalecany zakres wynosi 384–2 048 pikseli. Przewodnik edycji osobno zaleca obrazy do 3 072 pikseli, dlatego traktuj wybór wejścia jako przygotowanie potrzebnych szczegółów, a nie obietnicę, że każda rozdzielczość poprawia wynik. Użyj czytelnej, odpowiednio wykadrowanej referencji dla drobnego tekstu lub cech materiału.

Wyjścia są w formacie PNG. Proces producenta zwraca od jednego do sześciu wariantów, domyślnie jeden, i obsługuje łączną powierzchnię pikseli od 512 × 512 do 2 048 × 2 048 oraz proporcje od 1:8 do 8:1. Budżet powierzchni pikseli dopuszcza niektóre niekwadratowe wymiary, których dłuższy bok przekracza 2 048 pikseli. Jeśli nie określono rozmiaru, model zaleca rozdzielczość na podstawie opisu. Dobierz kształt do faktycznego miejsca użycia, a następnie porównaj wygenerowane warianty pod względem kompletności treści, szczegółów podmiotu i typografii w zamierzonym rozmiarze wyświetlania.

Inteligentne przepisywanie promptu jest domyślnie włączone. Bezpośrednie ulepszanie jest dostępne zarówno dla generowania, jak i edycji; ulepszanie agentowe dopracowuje prompty tekst-do-obrazu i nie może być używane do edycji obraz-do-obrazu. Thinking również jest domyślnie włączone i wymaga przepisywania promptu; dodaje pracę rozumowania i czas generowania. Negatywne prompty wskazują niepożądane elementy, a opcjonalne ziarno losowości może pomóc uzyskać bardziej spójne porównania wariantów. Jasny pozytywny opis nadal powinien określać podmiot, kompozycję i szczegóły do zachowania.

Praktyczna kontrola wyniku sprawdza dokładny tekst, liczby, kolejność czytania, zgodność z referencjami oraz krawędzie lub tekstury istotne dla projektu. Gdy określona część wymaga poprawki, zachowaj udaną kompozycję i opisz konkretną zmianę. Zachowaj wszystkie wybrane obrazy z ich promptem i referencjami, ponieważ lokalizacje wyjścia producenta wygasają po 24 godzinach. Udokumentowane tryby i limity Pro należą do wydania 3.0; obsługa dziesięciu referencji i natywnej przezroczystości opisana dla Qwen 2.1 to możliwości osobnego wydania.

Ailoot Ultra · Obrazy POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Start

Akceptowane dane wejściowe: Tekst · Obrazy
Wyniki: Obrazy

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Obrazy POST /v1/images/generations

Wejście: text, image
Wyjście: image

Pole	Typ	Wymaganie	Wartości i limity	Domyślnie
Pole`model`	Typ`string`	WymaganieWymagane	Wartości i limity qwen/qwen-image-3-pro	Domyślnie—
Pole`prompt`	Typ`string`	WymaganieWymagane	Wartości i limity Minimalna długość: 1	Domyślnie—
Pole`resolution`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 1K, 2K	Domyślnie—
Pole`aspect_ratio`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9	Domyślnie—
Pole`n`	Typ`integer`	WymaganieOpcjonalne	Wartości i limity Minimum: 1 Maksimum: 6	Domyślnie—
Pole`input_references`	Typ`array`	WymaganieOpcjonalne	Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 4	Domyślnie—
Pole`provider`	Typ`object`	WymaganieOpcjonalne	Wartości i limity	Domyślnie—

Parametry i cykl życia metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Cykl życia: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cennik

Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki: Nie określono Gdy wybrany jest tryb szybki
Tryb flex: Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania: Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Szacunkowe stawki do porównania

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

Konfiguracja	Tabela stawek	Przewidywana ilość	Jednostka rozliczeniowa	Opłata
KonfiguracjaBazowe stawki za tokeny	Tabela stawekStawka podstawowa	Przewidywana ilość—	Jednostka rozliczeniowa—	Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów
Konfiguracjaobraz wejściowy	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowaza obraz wejściowy	Opłata Wejście · obraz wejściowy · Szacunek tylko do porównania $0.006 za obraz wejściowy
KonfiguracjaSzacowany koszt generowania	Tabela stawek—	Przewidywana ilośćszacunek dla jednego generowania	Jednostka rozliczeniowa—	Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.08 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Obrazy

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Odbieranie i zapisywanie wyników

Ailoot Ultra · Obrazy

Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Inne odczyty treści

Odczytaj istniejące zasoby należące do Ciebie

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Zachowaj wszystkie ukończone wyniki

Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.

Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.

Pola odpowiedzi

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelu

Ailoot Ultra qwen/qwen-image-3-pro

Aliasy ścieżek metod

/v1/images

Powiązane ID modeli

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Jakie dane wejściowe i wyniki są dostępne?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Jakich pól używa żądanie?: POST /v1/images/generations · qwen/qwen-image-3-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
Jakie limity obowiązują?: POST /v1/images/generations · qwen/qwen-image-3-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro