Hvordan bruke Qwen Image 3 Pro API via DashScope: En utviklerveiledning

Hvordan bruke Qwen Image 3 Pro API via DashScope: En utviklerveiledning

Alibabas qwen-image-3.0-pro er flaggskipmodellen for bildegenerering som tilbys gjennom Model Studio, også kjent som DashScope eller Bailian. Den retter seg mot backend-utviklere som trenger et pålitelig tekst-til-bilde-endepunkt med forutsigbar prising. Den offisielle modell-ID-en qwen-image-3.0-pro er dokumentert i Alibabas Model Studio-katalog (Alibaba Cloud Model Studio docs, 2026), og du kan kalle den fra enhver HTTP-klient.

Denne veiledningen går gjennom full integrasjon. Ved slutten vil du ha en API-nøkkel, et fungerende cURL-kall, et Python-utdrag og en klar oversikt over kostnadsstrukturen per bilde.

Viktige punkter

• Modell-ID: qwen-image-3.0-pro, tilgjengelig på Alibaba Cloud Model Studio / DashScope på https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026).
• Autentisering: sett DASHSCOPE_API_KEY som en miljøvariabel, og send den deretter som et Bearer-token (Promptfoo, 2026).
• Referansepris: forgjengeren qwen-image-2.0-pro koster $0.075 per generert bilde ifølge Alibabas offisielle priser (Alibaba Cloud pricing, 2026).
• Hver bildemodell har en gratiskvote for testing før du betaler en krone (Alibaba Image API FAQ, 2026).

Forutsetninger

Før du skriver kode, bekreft at du har en Alibaba Cloud-konto med Model Studio-tilgang. Den offisielle "Første API-kall til Qwen"-guiden lister opp tre ting hver utvikler trenger: en API-nøkkel generert i Model Studio-konsollen, en Workspace ID knyttet til prosjektet ditt, og tilgang til DashScope HTTP-endepunktet (Alibaba Cloud, 2026).

Du trenger også grunnleggende verktøy. En terminal med cURL, Python 3.9 eller nyere, og requests-biblioteket dekker alt i denne veiledningen. Ingen proprietær SDK er nødvendig. Hvis du noen gang har kalt OpenAI API fra et skript, vil DashScope-mønsteret føles kjent, siden begge bruker Bearer-tokens og JSON-forespørselskropper.

Et anbefalt mønster er å holde én dedikert Workspace per miljø, slik at staging-nøkler aldri påvirker produksjonskvoter. Denne separasjonen gjør også kostnadsfordelingen renere ved slutten av måneden.

Trinn 1: Skaff deg din API-nøkkel og Workspace ID

API-nøkkelen er legitimasjonen som autoriserer hvert kall du gjør til qwen-image-3.0-pro. Alibabas startguide instruerer utviklere til å opprette nøkkelen inne i Model Studio-konsollen og deretter kopiere Workspace ID fra samme dashbord (Alibaba Cloud, 2026). Behandle begge verdiene som hemmeligheter.

Slik henter du dem:

1. Logg inn på Model Studio-konsollen på Alibaba Cloud-portalen.
2. Åpne API Keys-seksjonen og klikk Create API Key.
3. Kopier den genererte nøkkelen umiddelbart. Konsollen skjuler hele verdien etter opprettelse.
4. Merk Workspace ID som vises øverst på dashbordet.

Lagre nøkkelen i en passordbehandler eller teamets hemmelige backend. Ikke lim den inn i kildefiler. Workspace ID er mindre sensitiv, men fortsatt verdt å holde i konfigurasjon i stedet for inline.

Kildereferanse: Alibabas offisielle "Første API-kall til Qwen"-guide instruerer utviklere til å opprette en API-nøkkel i Model Studio-konsollen, kopiere Workspace ID fra samme dashbord, og kalle modeller via DashScope-endepunktet på https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026).

Trinn 2: Sett miljøvariabelen DASHSCOPE_API_KEY

Å laste nøkkelen inn i en miljøvariabel holder den utenfor koden din og utenfor versjonskontroll. Fellesskapsmønsteret dokumentert av Promptfoo er å sette en variabel kalt DASHSCOPE_API_KEY før du kjører skriptet ditt, som deretter leses av HTTP-klienten ved forespørselstidspunktet (Promptfoo, 2026).

På macOS og Linux:

export DASHSCOPE_API_KEY="sk-your-key-here"

På Windows PowerShell:

$env:DASHSCOPE_API_KEY = "sk-your-key-here"

For et permanent oppsett, legg til eksportlinjen i ~/.zshrc, ~/.bashrc, eller Windows brukerens miljøvariabler. Start terminalen på nytt etterpå. Verifiser at variabelen er lastet før du går videre:

echo $DASHSCOPE_API_KEY

Et vanlig oppsett er en .env-fil pluss en laster som python-dotenv, slik at samme konfigurasjon fungerer på tvers av lokal utvikling, CI og container-distribusjoner. Husk å legge til .env i .gitignore slik at nøkkelen aldri blir committed.

Trinn 3: Gjør ditt første bildegenereringskall med cURL

DashScope-endepunktet på https://dashscope-us.aliyuncs.com/api/v1 er inngangspunktet for hver Qwen-modell, inkludert qwen-image-3.0-pro (Alibaba Cloud, 2026). Kall bruker et Bearer-token i Authorization-headeren og en JSON-kropp som navngir modellen pluss din prompt.

Nedenfor er en illustrativ cURL-forespørsel basert på det dokumenterte endepunktet og autentiseringsmønsteret. Feltnavn og eksakte forespørselsstier følger DashScope-konvensjonen, men du bør bekrefte gjeldende skjema mot den offisielle API-referansen på Qwen API via DashScope før du sender til produksjon.

# Illustrativt eksempel. Bekreft eksakte feltnavn og stier mot:
# https://www.alibabacloud.com/help/en/model-studio/qwen-api-via-dashscope
curl -X POST "https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model": "qwen-image-3.0-pro",
    "input": {
      "prompt": "A cozy bookstore cafe in autumn, warm light, highly detailed"
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1
    }
  }'

Noen praktiske merknader:

• Noen DashScope-bildeendepunkter er asynkrone, noe som betyr at det første svaret returnerer en oppgave-ID, og du poller en annen URL for å hente det ferdige bildet. Sjekk API-referansen for den eksakte oppførselen til qwen-image-3.0-pro.
• Hold prompter under den dokumenterte token-grensen. Lange prompter kan bli avkortet uten varsel.
• Bruk size-parameteren som samsvarer med et av de støttede sideforholdene, ellers kan kallet falle tilbake til en standardverdi.

Kildereferanse: Det offisielle DashScope-endepunktet på https://dashscope-us.aliyuncs.com/api/v1 serverer qwen-image-3.0-pro, med full referanse for input- og output-parametere dokumentert av Alibaba Cloud (Alibaba Cloud, 2026).

Trinn 4: Analyser svaret i Python

Python er det vanligste språket for å pakke inn bilde-API-er fordi requests-biblioteket gjør JSON-parsing trivielt. Når kallet returnerer, trekker du ut den genererte bilde-URL-en, laster den ned og lagrer den på disk eller objektlagring.

Herd er et kort illustrativt skript. Som med cURL, bekreft feltnavnene i svaret mot den offisielle API-referansen før du stoler på dem.

# Illustrativt eksempel. Bekreft svarskjema mot:
# https://www.alibabacloud.com/help/en/model-studio/qwen-api-via-dashscope
import os
import requests

API_KEY = os.environ["DASHSCOPE_API_KEY"]
ENDPOINT = "https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

payload = {
    "model": "qwen-image-3.0-pro",
    "input": {
        "prompt": "A cozy bookstore cafe in autumn, warm light, highly detailed"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}

response = requests.post(ENDPOINT, headers=headers, json=payload)
response.raise_for_status()
data = response.json()

# Feltnavnene nedenfor er illustrative. Verifiser mot den offisielle API-referansen.
image_url = data["output"]["results"][0]["url"]
print("Generert bilde-URL:", image_url)

# Last ned filen
img = requests.get(image_url)
with open("output.png", "wb") as f:
    f.write(img.content)

Noen produksjonsklare tips:

• Pakk kallet inn i retry med eksponentiell backoff. Nettverksfeil skjer.
• Legg til en timeout. Bildegenerering kan ta flere sekunder.
• Logg full forespørsels-ID, vanligvis returnert i en svarheader, slik at Alibaba-støtte kan spore feil.

Det hjelper å legge til et tynt abstraksjonslag mellom API-klienten og forretningslogikken. På den måten endrer bytte av modeller senere (f.eks. til et redigeringsendepunkt eller en nyere Qwen-utgivelse) bare én modul.

Hvor mye koster Qwen Image 3 Pro?

Prisingen er per generert bilde, og Alibaba fakturerer deg kun for vellykkede generasjoner. Den offisielle prissiden lister qwen-image-2.0-pro til $0.075 per bilde (Alibaba Cloud pricing, 2026). Tredjepartsleverandører tilbyr Qwen-bildemodeller til forskjellige prispoeng: Fal lister en Qwen-bildemodell til omtrent $0.021 per bilde, og Replicate tar omtrent $0.030 per bilde ved 1024x1024 (Puter pricing breakdown, 2026; pricepertoken, 2026).

For qwen-image-3.0-pro spesifikt, behandle 2.0-pro-prisen som den nærmeste offisielle referansen, og verifiser deretter det gjeldende tallet på Model Studio-prissiden før budsjettering.

Kildereferanse: Alibabas Model Studio priser qwen-image-2.0-pro til $0.075 per generert bilde, og fakturerer kun vellykkede generasjoner, mens tredjepartsleverandører som Fal og Replicate lister Qwen-bildemodeller til henholdsvis omtrent $0.021 og $0.030 per bilde (Alibaba Cloud, 2026; Puter, 2026).

Et grovt månedlig budsjett for en liten app kan se slik ut:

Priser per juli 2026.

Gratiskvote og begrensninger

Hver bildemodell på Model Studio leveres med en gratiskvote, slik at du kan teste før du forplikter deg til å bruke penger (Alibaba Image API FAQ, 2026). Kvoten nullstilles etter en tidsplan dokumentert i FAQ-en.

Noen praktiske tips:

• Bruk gratiskvoten til å validere prompt-maler og parameterkombinasjoner.
• Overvåk bruken i Model Studio-dashbordet for å unngå overraskende regninger når du bytter til betalte nivåer.
• Hvis testene dine plutselig begynner å feile med kvotefeil, dobbeltsjekk om gratiskvoten utløp eller om du byttet Workspaces.

Utover tekst-til-bilde: Redigerings-API-en

Qwen-familien inkluderer også et dedikert endepunkt for bilderedigering. Det støtter multi-bilde input og output, tekstredigering i bilder, objektlegging, fjerning og flytting, og positur-endringer (Qwen-Image Edit API, 2026).

Dette er viktig fordi redigeringskall bruker en annen forespørselsform enn tekst-til-bilde-kall. Hvis produktet ditt trenger bakgrunnsbytte eller objektfjerning, vil du treffe et separat endepunkt med egne parametere og priser. Planlegg for to integrasjonsspor: ett for generering, ett for redigering.

FAQ

Hva er modell-ID-en for Qwen Image 3 Pro?

Den offisielle modell-ID-en er qwen-image-3.0-pro, tilgjengelig på Alibaba Cloud Model Studio / DashScope på https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026). Bruk denne eksakte strengen i model-feltet i forespørselskroppen din.

Hvordan autentiserer jeg DashScope API-kall?

Sett miljøvariabelen DASHSCOPE_API_KEY, og send den deretter som et Bearer-token i Authorization-headeren for hver forespørsel (Promptfoo, 2026). Hardkod aldri nøkkelen i kildefiler eller commit den til versjonskontroll.

Hvor mye koster Qwen Image 3 Pro per bilde?

Alibaba priser forgjengeren qwen-image-2.0-pro til $0.075 per bilde og fakturerer kun vellykkede generasjoner (Alibaba Cloud pricing, 2026). Tredjepartsleverandører som Fal og Replicate lister Qwen-bildemodeller til omtrent $0.021 og $0.030 per bilde. Verifiser gjeldende 3.0-pro-priser på den offisielle siden.

Er det en gratiskvote?

Ja. Hver bildemodell på Model Studio har en gratiskvote du kan bruke til testing før betalt fakturering starter (Alibaba Image API FAQ, 2026). Sjekk FAQ-en for nullstillingsfrekvens og grenser, som varierer per modell.

Støtter Qwen Image 3 Pro bilderedigering?

Redigering håndteres av et separat endepunkt kalt Qwen-Image Edit, som støtter multi-bilde IO, tekstredigering i bilder, objektlegging, fjerning og flytting, og positur-endringer (Qwen-Image Edit API, 2026). Tekst-til-bilde- og redigerings-API-ene har forskjellige forespørselsformer.

Konklusjon

Du har nå den fulle veien til ditt første qwen-image-3.0-pro-kall: en API-nøkkel fra Model Studio-konsollen, miljøvariabelen DASHSCOPE_API_KEY lastet, en fungerende cURL-forespørsel, og et Python-utdrag som analyserer og laster ned resultatet. Prismodellen per bilde, som starter fra $0.075 på Alibabas offisielle priser, gjør kostnadene forutsigbare når du skalerer.

To neste trinn vil skjerpe integrasjonen din. Først, bekreft de eksakte forespørsels- og svarfeltnavnene mot den offisielle API-referansen på Qwen API via DashScope, siden skjema-detaljer kan endre seg mellom modellversjoner. For det andre, hvis produktet ditt trenger redigeringer i stedet for ren generering, utforsk Qwen-Image Edit API, som låser opp objektfjerning, tekstredigering og positur-endringer gjennom et dedikert endepunkt.

Bygg lite, overvåk kvoten din, og send.