{ "aboutHtml": "

Qwen-Image-3.0 er Qwens tredjegenerasjons bildemodell, som kombinerer tekst-til-bilde-generering og referansebasert redigering i én modell. Standardutgaven balanserer bildekvalitet og responshastighet, mens Qwen-Image-3.0 Pro er den kvalitetsorienterte flaggskipvarianten. En forespørsel produserer et bilde: en plakat, en illustrert forklaring, en produktscene, et storyboard eller et bearbeidet fotografi, ikke et redigerbart dokument eller et fungerende grensesnitt.

Egenskapene for rikt innhold passer til et lerret med flere relaterte seksjoner eller et nestet visuelt oppsett. Klargjør overskrifter, nøyaktig ordlyd, hierarki og forholdet mellom panelene før du legger til stildetaljer. For en produktsammenligning angir en nyttig beskrivelse hovedvisningen av produktet, egenskapene som skal merkes, og leserekkefølgen for støttepanelene. For et storyboard beskriver du motiv, handling og bildetekst for hvert panel separat. Anbefalt maksimal promptlengde er 4 500 tokener; bruk plassen på innholdet og oppsettet bildet faktisk trenger.

Modellen støtter detaljerte teksturer, typografi ned til liten tekst demonstrert ved 10 piksler og innebygd gjengivelse på 12 språk med flere skrifttyper og kunstneriske stiler. Disse egenskapene kan kombinere et realistisk objekt med informasjonsrik grafikk i stedet for å tvinge frem et valg mellom et fotografi og et teksttungt oppsett. Oppgi de nøyaktige ordene og tallene som skal gjengis, det tiltenkte språket og hvor de skal stå. Behandle et generert grensesnitt som en visuell skisse: knapper, diagrammer og etiketter i bildet implementerer ikke funksjonaliteten til en applikasjon.

Redigering kan endre tekst, legge til eller fjerne objekter, flytte elementer, justere handlingen til et motiv, overføre en stil eller forbedre detaljene i et skadet bilde. Oppgi ett til tre bilder og én tydelig redigeringsinstruksjon. Bildenummereringen følger rekkefølgen bildene er oppgitt i, så angi hvilket bilde som bidrar med motivet, hvilket som gir et plagg eller objekt, og hvilket som gir omgivelsene. For en produktscene kan du be om å plassere objektet fra bilde 1 i miljøet fra bilde 2, samtidig som egenskapene som kjennetegner produktet, bevares. Gjør endringene og kravene til bevaring eksplisitte.

Den spesifikke arbeidsflyten for bildeinndata godtar JPG, JPEG, PNG, BMP, TIFF, WebP og GIF; bare den første rammen i en animert GIF behandles. Hvert bilde kan være opptil 10 MB. Det gjeldende API-et godtar dimensjoner fra 1 til 8 000 piksler med et forhold mellom lang- og kortside på høyst 10:1, og anbefaler 384–2 048 piksler for gode resultater. Velg et inndatabilde som tydelig viser detaljene som skal overføres eller redigeres. En tett beskåret referanse kan skjule den omkringliggende strukturen som trengs for å plassere et objekt naturlig.

Utdataformatet er PNG, med ett til seks bilder per forespørsel og ett som standard. Pikselarealet for utdata går fra 512 × 512 til 2 048 × 2 048, med sideforhold mellom 1:8 og 8:1; dette er arealgrenser, ikke en regel om at hver side må være høyst 2 048 piksler. Hvis det ikke oppgis en størrelse, anbefaler modellen en oppløsning ut fra prompten. Velg liggende, kvadratisk eller stående komposisjon for den tiltenkte bruken, og undersøk det returnerte bildet i den faktiske størrelsen slik at små etiketter og fine detaljer kan vurderes der de skal vises.

Omskriving av prompten er aktivert som standard i produsentens arbeidsflyt. Direkte forbedring fungerer både for generering og redigering; agentbasert forbedring er en mer omfattende omskrivingsmodus bare for tekst-til-bilde og avvises ved bilde-til-bilde-redigering. Resonnering er aktivert som standard, krever omskriving av prompten og øker genereringstiden. Negative prompter kan beskrive uønskede elementer, mens en fast seed-verdi hjelper med å sammenligne variasjoner. Oppgi utelatelser og nøyaktige krav til bevaring tydelig, fremfor å forvente at en seed-verdi får en beskrivelse som endres, til å returnere et identisk bilde.

For et nyttig sluttresultat undersøker du den gjengitte teksten, enhetene, panelrekkefølgen og detaljene som identifiserer motivet, og reviderer deretter den konkrete delen som ikke oppfylte beskrivelsen. Et svar med flere bilder gir alternativer å sammenligne; behold hvert returnerte bilde knyttet til prompten og referansene som produserte det. Produsentens bildeadresser utløper etter 24 timer, så behold selve bildefilen når resultatet blir en del av et prosjekt. Standardutgaven 3.0 er fortsatt atskilt fra Pro og fra Qwen 2.1-modeller med deres ulike antall referanser og funksjoner for gjennomsiktighet.

", "aboutText": "Qwen-Image-3.0 er Qwens tredjegenerasjons bildemodell, som kombinerer tekst-til-bilde-generering og referansebasert redigering i én modell. Standardutgaven balanserer bildekvalitet og responshastighet, mens Qwen-Image-3.0 Pro er den kvalitetsorienterte flaggskipvarianten. En forespørsel produserer et bilde: en plakat, en illustrert forklaring, en produktscene, et storyboard eller et bearbeidet fotografi, ikke et redigerbart dokument eller et fungerende grensesnitt.\n\nEgenskapene for rikt innhold passer til et lerret med flere relaterte seksjoner eller et nestet visuelt oppsett. Klargjør overskrifter, nøyaktig ordlyd, hierarki og forholdet mellom panelene før du legger til stildetaljer. For en produktsammenligning angir en nyttig beskrivelse hovedvisningen av produktet, egenskapene som skal merkes, og leserekkefølgen for støttepanelene. For et storyboard beskriver du motiv, handling og bildetekst for hvert panel separat. Anbefalt maksimal promptlengde er 4 500 tokener; bruk plassen på innholdet og oppsettet bildet faktisk trenger.\n\nModellen støtter detaljerte teksturer, typografi ned til liten tekst demonstrert ved 10 piksler og innebygd gjengivelse på 12 språk med flere skrifttyper og kunstneriske stiler. Disse egenskapene kan kombinere et realistisk objekt med informasjonsrik grafikk i stedet for å tvinge frem et valg mellom et fotografi og et teksttungt oppsett. Oppgi de nøyaktige ordene og tallene som skal gjengis, det tiltenkte språket og hvor de skal stå. Behandle et generert grensesnitt som en visuell skisse: knapper, diagrammer og etiketter i bildet implementerer ikke funksjonaliteten til en applikasjon.\n\nRedigering kan endre tekst, legge til eller fjerne objekter, flytte elementer, justere handlingen til et motiv, overføre en stil eller forbedre detaljene i et skadet bilde. Oppgi ett til tre bilder og én tydelig redigeringsinstruksjon. Bildenummereringen følger rekkefølgen bildene er oppgitt i, så angi hvilket bilde som bidrar med motivet, hvilket som gir et plagg eller objekt, og hvilket som gir omgivelsene. For en produktscene kan du be om å plassere objektet fra bilde 1 i miljøet fra bilde 2, samtidig som egenskapene som kjennetegner produktet, bevares. Gjør endringene og kravene til bevaring eksplisitte.\n\nDen spesifikke arbeidsflyten for bildeinndata godtar JPG, JPEG, PNG, BMP, TIFF, WebP og GIF; bare den første rammen i en animert GIF behandles. Hvert bilde kan være opptil 10 MB. Det gjeldende API-et godtar dimensjoner fra 1 til 8 000 piksler med et forhold mellom lang- og kortside på høyst 10:1, og anbefaler 384–2 048 piksler for gode resultater. Velg et inndatabilde som tydelig viser detaljene som skal overføres eller redigeres. En tett beskåret referanse kan skjule den omkringliggende strukturen som trengs for å plassere et objekt naturlig.\n\nUtdataformatet er PNG, med ett til seks bilder per forespørsel og ett som standard. Pikselarealet for utdata går fra 512 × 512 til 2 048 × 2 048, med sideforhold mellom 1:8 og 8:1; dette er arealgrenser, ikke en regel om at hver side må være høyst 2 048 piksler. Hvis det ikke oppgis en størrelse, anbefaler modellen en oppløsning ut fra prompten. Velg liggende, kvadratisk eller stående komposisjon for den tiltenkte bruken, og undersøk det returnerte bildet i den faktiske størrelsen slik at små etiketter og fine detaljer kan vurderes der de skal vises.\n\nOmskriving av prompten er aktivert som standard i produsentens arbeidsflyt. Direkte forbedring fungerer både for generering og redigering; agentbasert forbedring er en mer omfattende omskrivingsmodus bare for tekst-til-bilde og avvises ved bilde-til-bilde-redigering. Resonnering er aktivert som standard, krever omskriving av prompten og øker genereringstiden. Negative prompter kan beskrive uønskede elementer, mens en fast seed-verdi hjelper med å sammenligne variasjoner. Oppgi utelatelser og nøyaktige krav til bevaring tydelig, fremfor å forvente at en seed-verdi får en beskrivelse som endres, til å returnere et identisk bilde.\n\nFor et nyttig sluttresultat undersøker du den gjengitte teksten, enhetene, panelrekkefølgen og detaljene som identifiserer motivet, og reviderer deretter den konkrete delen som ikke oppfylte beskrivelsen. Et svar med flere bilder gir alternativer å sammenligne; behold hvert returnerte bilde knyttet til prompten og referansene som produserte det. Produsentens bildeadresser utløper etter 24 timer, så behold selve bildefilen når resultatet blir en del av et prosjekt. Standardutgaven 3.0 er fortsatt atskilt fra Pro og fra Qwen 2.1-modeller med deres ulike antall referanser og funksjoner for gjennomsiktighet.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9b4fb28bc7d9b28f1250410e9c50e4744b5f0ea9f08ab731e93329e9d54b7459", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nb", "methods": [ { "html": "
Al

Qwen: Qwen Image 3

Alibaba /qwen/qwen-image-3

Start

Qwen-Image-3.0 kombinerer bildegenerering og redigering for informasjonsrike oppsett, detaljerte scener og flerspråklig typografi. Standardutgaven balanserer kvalitet og hastighet og tar imot en tekstbeskrivelse eller opptil tre bilder med en redigeringsinstruksjon.

Godkjente inndata
Tekst · Bilder
Resultater
Bilder
Om modellen

Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.

Qwen-Image-3.0 er Qwens tredjegenerasjons bildemodell, som kombinerer tekst-til-bilde-generering og referansebasert redigering i én modell. Standardutgaven balanserer bildekvalitet og responshastighet, mens Qwen-Image-3.0 Pro er den kvalitetsorienterte flaggskipvarianten. En forespørsel produserer et bilde: en plakat, en illustrert forklaring, en produktscene, et storyboard eller et bearbeidet fotografi, ikke et redigerbart dokument eller et fungerende grensesnitt.

Egenskapene for rikt innhold passer til et lerret med flere relaterte seksjoner eller et nestet visuelt oppsett. Klargjør overskrifter, nøyaktig ordlyd, hierarki og forholdet mellom panelene før du legger til stildetaljer. For en produktsammenligning angir en nyttig beskrivelse hovedvisningen av produktet, egenskapene som skal merkes, og leserekkefølgen for støttepanelene. For et storyboard beskriver du motiv, handling og bildetekst for hvert panel separat. Anbefalt maksimal promptlengde er 4 500 tokener; bruk plassen på innholdet og oppsettet bildet faktisk trenger.

Modellen støtter detaljerte teksturer, typografi ned til liten tekst demonstrert ved 10 piksler og innebygd gjengivelse på 12 språk med flere skrifttyper og kunstneriske stiler. Disse egenskapene kan kombinere et realistisk objekt med informasjonsrik grafikk i stedet for å tvinge frem et valg mellom et fotografi og et teksttungt oppsett. Oppgi de nøyaktige ordene og tallene som skal gjengis, det tiltenkte språket og hvor de skal stå. Behandle et generert grensesnitt som en visuell skisse: knapper, diagrammer og etiketter i bildet implementerer ikke funksjonaliteten til en applikasjon.

Redigering kan endre tekst, legge til eller fjerne objekter, flytte elementer, justere handlingen til et motiv, overføre en stil eller forbedre detaljene i et skadet bilde. Oppgi ett til tre bilder og én tydelig redigeringsinstruksjon. Bildenummereringen følger rekkefølgen bildene er oppgitt i, så angi hvilket bilde som bidrar med motivet, hvilket som gir et plagg eller objekt, og hvilket som gir omgivelsene. For en produktscene kan du be om å plassere objektet fra bilde 1 i miljøet fra bilde 2, samtidig som egenskapene som kjennetegner produktet, bevares. Gjør endringene og kravene til bevaring eksplisitte.

Den spesifikke arbeidsflyten for bildeinndata godtar JPG, JPEG, PNG, BMP, TIFF, WebP og GIF; bare den første rammen i en animert GIF behandles. Hvert bilde kan være opptil 10 MB. Det gjeldende API-et godtar dimensjoner fra 1 til 8 000 piksler med et forhold mellom lang- og kortside på høyst 10:1, og anbefaler 384–2 048 piksler for gode resultater. Velg et inndatabilde som tydelig viser detaljene som skal overføres eller redigeres. En tett beskåret referanse kan skjule den omkringliggende strukturen som trengs for å plassere et objekt naturlig.

Utdataformatet er PNG, med ett til seks bilder per forespørsel og ett som standard. Pikselarealet for utdata går fra 512 × 512 til 2 048 × 2 048, med sideforhold mellom 1:8 og 8:1; dette er arealgrenser, ikke en regel om at hver side må være høyst 2 048 piksler. Hvis det ikke oppgis en størrelse, anbefaler modellen en oppløsning ut fra prompten. Velg liggende, kvadratisk eller stående komposisjon for den tiltenkte bruken, og undersøk det returnerte bildet i den faktiske størrelsen slik at små etiketter og fine detaljer kan vurderes der de skal vises.

Omskriving av prompten er aktivert som standard i produsentens arbeidsflyt. Direkte forbedring fungerer både for generering og redigering; agentbasert forbedring er en mer omfattende omskrivingsmodus bare for tekst-til-bilde og avvises ved bilde-til-bilde-redigering. Resonnering er aktivert som standard, krever omskriving av prompten og øker genereringstiden. Negative prompter kan beskrive uønskede elementer, mens en fast seed-verdi hjelper med å sammenligne variasjoner. Oppgi utelatelser og nøyaktige krav til bevaring tydelig, fremfor å forvente at en seed-verdi får en beskrivelse som endres, til å returnere et identisk bilde.

For et nyttig sluttresultat undersøker du den gjengitte teksten, enhetene, panelrekkefølgen og detaljene som identifiserer motivet, og reviderer deretter den konkrete delen som ikke oppfylte beskrivelsen. Et svar med flere bilder gir alternativer å sammenligne; behold hvert returnerte bilde knyttet til prompten og referansene som produserte det. Produsentens bildeadresser utløper etter 24 timer, så behold selve bildefilen når resultatet blir en del av et prosjekt. Standardutgaven 3.0 er fortsatt atskilt fra Pro og fra Qwen 2.1-modeller med deres ulike antall referanser og funksjoner for gjennomsiktighet.

Tilgjengelig i Ailoot · inndata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations
Inndatatyper
text, image
Utdatatyper
image
FeltTypeKravVerdier & grenserStandard
FeltmodelTypestringKravPåkrevdVerdier & grenser
qwen/qwen-image-3
Standard—
FeltpromptTypestringKravPåkrevdVerdier & grenser
Minste lengde: 1
Standard—
FeltresolutionTypestringKravValgfrittVerdier & grenser
1K, 2K
Standard—
Feltaspect_ratioTypestringKravValgfrittVerdier & grenser
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
Standard—
FeltnTypeintegerKravValgfrittVerdier & grenser
Minimum: 1
Maksimum: 6
Standard—
Feltinput_referencesTypearrayKravValgfrittVerdier & grenser
Minste antall elementer: 0
Maksimalt antall elementer: 4
Standard—
FeltproviderTypeobjectKravValgfrittVerdier & grenserStandard—
Metodeparametere og livssyklus
ParameterAvtale
Parametercontent_typeAvtaleapplication/json
ParameterrequiredAvtalemodel, prompt
Parametermaterial_typesAvtaletext, image

Livssyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Slik beregnes det endelige beløpet

De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.

Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.

Hurtigmodus
Ikke angitt Når hurtigmodus er valgt
Flex-modus
Ikke angitt Når flex-modus er valgt
Maksimal resonneringsinnsats
Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats

Estimerte satser for sammenligning

Priser etter konfigurasjon

Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.

KonfigurasjonPrisplanForventet mengdeFaktureringsenhetKostnad
KonfigurasjonGrunnpriser for tokenerPrisplanGrunnsatsForventet mengde—Faktureringsenhet—Kostnad
Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener
Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener
Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener
Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener
Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener
KonfigurasjonInndatabildePrisplan—Forventet mengde—Faktureringsenhetper inndatabildeKostnad
Inndata · inndatabilde · Estimat kun for sammenligning $0.006 per inndatabilde
KonfigurasjonAnslått genereringskostnadPrisplan—Forventet mengdeestimat for én genereringFaktureringsenhet—Kostnad
Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.06 estimat før generering

Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen.

Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →

Eksempelforespørsler

Ailoot Ultra · Bilder

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

Motta og lagre resultater

Ailoot Ultra · Bilder

Last ned hvert returnerte bilde eller lagre Base64-innholdet

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

Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.

Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.

Hvis det opprinnelige svaret må kontrolleres

Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.

Svarfelter
FeltType
FeltcreatedType
Feltdata[].urlType
Feltdata[].b64_jsonType
FeltusageType

Aliaser

Modellaliaser

Ailoot Ultra qwen/qwen-image-3

Aliaser for metodestier

/v1/images

Tilknyttede anroper-ID-er

qwen/qwen-image-3

", "method_identity": { "effective_request_model_id": "qwen/qwen-image-3", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "qwen/qwen-image-3", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|qwen%2Fqwen-image-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt." }, "outputs": { "all_results": "Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "qwen/qwen-image-3" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1K", "2K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "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" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 4, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "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" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 4, "minItems": 0, "type": "array" }, "model": { "enum": [ "qwen/qwen-image-3" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "1K", "2K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "qwen/qwen-image-3", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "faktisk returnert task_id eller oppføring i mediebiblioteket", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "input image", "units": [ { "amount": "0.006", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0.006", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "basis": "Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Anslått genereringskostnad", "units": [ { "amount": "0.06", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.06", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"