Käytä mallia Qwen Image 3.0 Rivya Public API v1:n kautta malli-ID:llä qwen-image-3; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTeksti tai URL valmis; referenssimoodit käyttävät Files API:aKuva

API-malli-ID

qwen-image-3

Syötteet

text, file

Files API

Vaaditaan referenssimoodeissa

Peruskrediitit

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

Kyvykkyys

Kuva

Laskutus

FIXED

Prompt-raja

800 merkkiä

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

Avain	Tyyppi	Pakollinen	Oletus	Kuvaus
model	string	Kyllä	qwen-image-3	Käytä qwen-image-3-arvoa API-malli-ID:nä.
prompt	string	Kyllä	-	Enintään 800 merkkiä tälle mallille.
params	object	Kyllä	-	Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_id	string	Ei	-	Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

Avain	Tyyppi	Pakollinen	Oletus	Alue	Vaihtoehdot	Kuvaus
resolution	select	Kyllä	1K	-	1K, 2K	Tarkkuus
image_size	select	Ei	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Kuvan koko
output_format	select	Ei	png	-	png, jpeg	Tulostusmuoto
prompt_extend	select	Ei	true	-	true, false	Anna mallin muotoilla yksinkertainen positiivinen kehote uudelleen ennen luontia tai poista toiminto käytöstä, jos haluat hallita sanamuotoa tarkemmin.
nsfw_checker	select	Ei	false	-	false, true	Ota mallin valinnainen sisältösuodatin käyttöön. Mikään automaattinen suodatin ei voi taata täydellistä kattavuutta.
negative_prompt	text	Ei	-	-	-	Negatiivinen kehote
seed	number	Ei	1	min 0 / max 2147483647 / step 1	-	Jätä tyhjäksi, jos haluat joka kerta uuden satunnaisen tuloksen. Saman kokonaisluvun käyttäminen uudelleen helpottaa aiemman tuloksen toistamista tai hienosäätöä. Tulos pysyy lähempänä vain silloin, kun kehote ja muut keskeiset asetukset ovat myös samankaltaisia, eikä se takaa täsmälleen samaa lopputulosta.

Latauskäytäntö

Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.

Referenssisääntö

Viitekuvat: Lataa enintään kolme JPEG-, PNG-, WebP-, BMP-, GIF- tai TIFF-kuvaa, joiden kunkin koko on enintään 10 MB.

Enimmäistiedostot

Hyväksytyt tiedostotyypit

image

Duration token

Video- ja äänireferenssien pitäisi kantaa /api/v1/files-reitin durationToken-arvoa, kun keston varmennus vaaditaan.

kind	Enimmäiskoko	MIME-tyypit
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Minimipyyntö

{
  "model": "qwen-image-3",
  "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": "Valinnaiset vältettävät elementit tai virhetyypit, enintään 5 000 merkkiä.",
    "seed": 1
  }
}

Referenssitiedostopyyntö

{
  "model": "qwen-image-3",
  "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": "Valinnaiset vältettävät elementit tai virhetyypit, enintään 5 000 merkkiä.",
    "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"
      }
    ]
  }
}

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

{
  "id": "task_qwen_image_3_example",
  "status": "queued",
  "model": "qwen-image-3",
  "reserved_credits": 5,
  "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
}

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Jotkin moodit vaativat Files API -referenssilatauksia.

Qwen Image 3.0 API -integraatio