Używaj Qwen Image 3.0 Pro przez Rivya Public API v1 z identyfikatorem modelu qwen-image-3-pro, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APITekst lub URL gotowe; tryby referencyjne używają Files APIObraz

Identyfikator modelu API

qwen-image-3-pro

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

Możliwość

Obraz

Rozliczenia

FIXED

Limit promptu

800 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	qwen-image-3-pro	Użyj qwen-image-3-pro jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 800 znaków dla tego modelu.
params	object	Tak	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
resolution	select	Tak	1K	-	1K, 2K	Rozdzielczość
image_size	select	Nie	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Rozmiar obrazu
output_format	select	Nie	png	-	png, jpeg	Format wyniku
prompt_extend	select	Nie	true	-	true, false	Pozwól modelowi przeredagować prosty prompt pozytywny przed generowaniem albo wyłącz tę opcję, aby ściślej kontrolować sformułowania.
nsfw_checker	select	Nie	false	-	false, true	Włącz opcjonalny filtr treści modelu. Żaden automatyczny filtr nie gwarantuje pełnego pokrycia.
negative_prompt	text	Nie	-	-	-	Prompt negatywny
seed	number	Nie	1	min 0 / max 2147483647 / step 1	-	Pozostaw puste, aby za każdym razem uzyskać nowy losowy wynik. Ponowne użycie tej samej liczby całkowitej ułatwia odtworzenie albo dopracowanie poprzedniego wyniku. Wynik pozostaje bliższy tylko wtedy, gdy prompt i inne kluczowe ustawienia również pozostają podobne; nie jest to gwarantowane dopasowanie 1:1.

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Obrazy referencyjne: Prześlij do trzech obrazów JPEG, PNG, WebP, BMP, GIF lub TIFF o rozmiarze nie większym niż 10 MB każdy.

Maks. plików

Akceptowane rodzaje plików

image

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy MIME
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Żądanie minimalne

{
  "model": "qwen-image-3-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "Opcjonalne elementy lub typowe błędy, których należy unikać; maksymalnie 5,000 znaków.",
    "seed": 1
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "qwen-image-3-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "Opcjonalne elementy lub typowe błędy, których należy unikać; maksymalnie 5,000 znaków.",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się powodzeniem albo błędem.

{
  "id": "task_qwen_image_3_pro_example",
  "status": "queued",
  "model": "qwen-image-3-pro",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Qwen Image 3.0 Pro