Sådan bruger du Qwen Image 3 Pro API via DashScope: En udviklervejledning

Sådan bruger du Qwen Image 3 Pro API via DashScope: En udviklervejledning

Alibabas qwen-image-3.0-pro er flagskibsmodellen til billedgenerering, der leveres gennem Model Studio, også kendt som DashScope eller Bailian. Den er rettet mod backend-udviklere, der har brug for et pålideligt tekst-til-billede-slutpunkt med forudsigelig prissætning. Det officielle model-ID qwen-image-3.0-pro er dokumenteret i Alibabas Model Studio-katalog (Alibaba Cloud Model Studio docs, 2026), og du kan kalde det fra enhver HTTP-klient.

Denne vejledning gennemgår den fulde integration. Til sidst vil du have en API-nøgle, et fungerende cURL-kald, et Python-snippet og et klart overblik over omkostningsstrukturen pr. billede.

Vigtigste pointer

• Model-ID: qwen-image-3.0-pro, leveret på Alibaba Cloud Model Studio / DashScope på https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026).
• Godkendelse: indstil DASHSCOPE_API_KEY som en miljøvariabel, og send den derefter som et Bearer-token (Promptfoo, 2026).
• Referencepris: forgængeren qwen-image-2.0-pro koster $0.075 pr. genereret billede på Alibabas officielle prissætning (Alibaba Cloud pricing, 2026).
• Hver billedmodel har en gratis kvote til test, før du betaler en krone (Alibaba Image API FAQ, 2026).

Forudsætninger

Før du skriver kode, skal du bekræfte, at du har en Alibaba Cloud-konto med Model Studio-adgang. Den officielle "Første API-kald til Qwen"-guide lister tre ting, som enhver udvikler har brug for: en API-nøgle genereret i Model Studio-konsollen, et Workspace ID knyttet til dit projekt og adgang til DashScope HTTP-slutpunktet (Alibaba Cloud, 2026).

Du har også brug for grundlæggende værktøjer. En terminal med cURL, Python 3.9 eller nyere og requests-biblioteket dækker alt i denne vejledning. Ingen proprietær SDK er påkrævet. Hvis du nogensinde har kaldt OpenAI API fra et script, vil DashScope-mønsteret føles velkendt, da begge bruger Bearer-tokens og JSON-anmodningsorganer.

Et anbefalet mønster er at holde ét dedikeret Workspace pr. miljø, så staging-nøgler aldrig rører produktionskvoter. Denne adskillelse gør også omkostningsfordelingen renere ved udgangen af måneden.

Trin 1: Hent din API-nøgle og Workspace ID

API-nøglen er den legitimationsoplysning, der godkender hvert kald, du foretager til qwen-image-3.0-pro. Alibabas startguide instruerer udviklere til at oprette nøglen i Model Studio-konsollen og derefter kopiere Workspace ID fra det samme dashboard (Alibaba Cloud, 2026). Behandl begge værdier som hemmeligheder.

Sådan hentes de:

1. Log ind på Model Studio-konsollen på Alibaba Cloud-portalen.
2. Åbn sektionen API Keys og klik på Create API Key.
3. Kopier den genererede nøgle med det samme. Konsollen skjuler den fulde værdi efter oprettelsen.
4. Bemærk Workspace ID, der vises øverst på dashboardet.

Gem nøglen i en adgangskodeadministrator eller dit teams hemmelige backend. Indsæt den ikke i kildefiler. Workspace ID er mindre følsomt, men stadig værd at holde i konfigurationen snarere end inline.

Citationskapsel: Alibabas officielle "Første API-kald til Qwen"-guide instruerer udviklere til at oprette en API-nøgle i Model Studio-konsollen, kopiere Workspace ID fra det samme dashboard og kalde modeller via DashScope-slutpunktet på https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026).

Trin 2: Indstil DASHSCOPE_API_KEY miljøvariablen

Indlæsning af nøglen i en miljøvariabel holder den ude af din kode og ude af versionskontrol. Det fælles mønster dokumenteret af Promptfoo er at indstille en variabel kaldet DASHSCOPE_API_KEY, før du kører dit script, som derefter læses af HTTP-klienten på anmodningstidspunktet (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 en permanent opsætning skal du tilføje eksportlinjen til din ~/.zshrc, ~/.bashrc eller Windows-brugerens miljøvariabler. Genstart din terminal bagefter. Bekræft, at variablen er indlæst, før du fortsætter:

echo $DASHSCOPE_API_KEY

En almindelig opsætning er en .env-fil plus en loader som python-dotenv, så den samme konfiguration fungerer på tværs af lokal udvikling, CI og containerimplementeringer. Husk at tilføje .env til .gitignore, så nøglen aldrig bliver committet.

Trin 3: Foretag dit første billedgenereringskald med cURL

DashScope-slutpunktet på https://dashscope-us.aliyuncs.com/api/v1 er indgangspunktet for hver Qwen-model, inklusive qwen-image-3.0-pro (Alibaba Cloud, 2026). Kald bruger et Bearer-token i Authorization-headeren og en JSON-krop, der navngiver modellen plus din prompt.

Nedenfor er en illustrativ cURL-anmodning baseret på det dokumenterede slutpunkt og godkendelsesmønster. Feltnavne og nøjagtige anmodningsstier følger DashScope-konventionen, men du bør bekræfte det aktuelle skema mod den officielle API-reference på Qwen API via DashScope, før du sender til produktion.

# Illustrativt eksempel. Bekræft nøjagtige feltnavne og stier mod:
# 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
    }
  }'

Et par praktiske bemærkninger:

• Nogle DashScope-billedslutpunkter er asynkrone, hvilket betyder, at det første svar returnerer et opgave-ID, og du poller en anden URL for at hente det færdige billede. Kontroller API-referencen for den nøjagtige adfærd af qwen-image-3.0-pro.
• Hold prompts under den dokumenterede token-grænse. Lange prompts kan afkortes lydløst.
• Brug size-parameteren, der matcher et af de understøttede billedformater, ellers kan kaldet falde tilbage til en standard.

Citationskapsel: Det officielle DashScope-slutpunkt på https://dashscope-us.aliyuncs.com/api/v1 serverer qwen-image-3.0-pro, med fuld input- og outputparameterreference dokumenteret af Alibaba Cloud (Alibaba Cloud, 2026).

Trin 4: Parse svaret i Python

Python er det mest almindelige sprog til at indpakke billed-API'er, fordi requests-biblioteket gør JSON-parsing triviel. Når kaldet returnerer, udtrækker du den genererede billed-URL, downloader den og gemmer den på disk eller objektlager.

Hernede er et kort illustrativt script. Som med cURL skal du bekræfte feltnavnene i svaret mod den officielle API-reference, før du stoler på dem.

# Illustrativt eksempel. Bekræft svarskema mod:
# 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()

# Feltnavne nedenfor er illustrative. Verificer mod den officielle API-reference.
image_url = data["output"]["results"][0]["url"]
print("Generated image URL:", image_url)

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

Et par produktionstips:

• Indpak kaldet i retry med eksponentiel backoff. Netværksfejl sker.
• Tilføj en timeout. Billedgenerering kan tage flere sekunder.
• Log det fulde anmodnings-ID, der normalt returneres i en svarheader, så Alibaba support kan spore fejl.

Det hjælper at tilføje et tyndt abstraktionslag mellem API-klienten og forretningslogikken. På den måde ændrer udskiftning af modeller senere (f.eks. til et redigeringsslutpunkt eller en nyere Qwen-udgivelse) kun ét modul.

Hvor meget koster Qwen Image 3 Pro?

Prisen er pr. genereret billede, og Alibaba fakturerer dig kun for succesfulde generationer. Den officielle prisside viser qwen-image-2.0-pro til $0.075 pr. billede (Alibaba Cloud pricing, 2026). Tredjepartsudbydere tilbyder Qwen-billedmodeller til forskellige prispunkter: Fal lister en Qwen-billedmodel til ca. $0.021 pr. billede, og Replicate opkræver omkring $0.030 pr. billede ved 1024x1024 (Puter pricing breakdown, 2026; pricepertoken, 2026).

For qwen-image-3.0-pro specifikt skal du behandle 2.0-pro-prisen som den nærmeste officielle reference og derefter verificere det aktuelle tal på Model Studio-prissiden, før du budgetterer.

Citationskapsel: Alibabas Model Studio prissætter qwen-image-2.0-pro til $0.075 pr. genereret billede, og fakturerer kun succesfulde generationer, mens tredjepartsudbydere som Fal og Replicate lister Qwen-billedmodeller til henholdsvis ca. $0.021 og $0.030 pr. billede (Alibaba Cloud, 2026; Puter, 2026).

Et groft månedligt budget for en lille app kan se sådan ud:

Priser pr. juli 2026.

Gratis kvote og grænser

Hver billedmodel på Model Studio leveres med en gratis kvote, så du kan teste, før du forpligter dig til at bruge penge (Alibaba Image API FAQ, 2026). Kvoten nulstilles efter en tidsplan, der er dokumenteret i FAQ'en.

Et par praktiske tips:

• Brug den gratis kvote til at validere promptskabeloner og parameterkombinationer.
• Overvåg brugen i Model Studio-dashboardet for at undgå overraskende regninger, når du skifter til betalte niveauer.
• Hvis dine tests pludselig begynder at fejle med kvotefejl, skal du dobbelttjekke, om det gratis niveau er udløbet, eller om du har skiftet Workspace.

Ud over tekst-til-billede: Redigerings-API'en

Qwen-familien inkluderer også et dedikeret billedredigeringsslutpunkt. Det understøtter input og output af flere billeder, tekstredigering i billeder, tilføjelse, fjernelse og flytning af objekter samt ændringer i positur (Qwen-Image Edit API, 2026).

Dette er vigtigt, fordi redigeringskald bruger en anden anmodningsform end tekst-til-billede-kald. Hvis dit produkt har brug for baggrundsudskiftning eller fjernelse af objekter, vil du ramme et separat slutpunkt med sine egne parametre og prissætning. Planlæg for to integrationsspor: et til generering, et til redigering.

Ofte stillede spørgsmål

Hvad er model-ID'et for Qwen Image 3 Pro?

Det officielle model-ID er qwen-image-3.0-pro, der serveres på Alibaba Cloud Model Studio / DashScope på https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026). Brug denne nøjagtige streng i model-feltet i din anmodningskrop.

Hvordan godkender jeg DashScope API-kald?

Indstil miljøvariablen DASHSCOPE_API_KEY, og send den derefter som et Bearer-token i Authorization-headeren for hver anmodning (Promptfoo, 2026). Hardcode aldrig nøglen i kildefiler eller commit den til versionskontrol.

Hvor meget koster Qwen Image 3 Pro pr. billede?

Alibaba prissætter forgængeren qwen-image-2.0-pro til $0.075 pr. billede og fakturerer kun succesfulde generationer (Alibaba Cloud pricing, 2026). Tredjepartsudbydere som Fal og Replicate lister Qwen-billedmodeller til henholdsvis ca. $0.021 og $0.030 pr. billede. Verificer den aktuelle 3.0-pro-prissætning på den officielle side.

Er der en gratis kvote?

Ja. Hver billedmodel på Model Studio har en gratis kvote, du kan bruge til test, før betalt fakturering træder i kraft (Alibaba Image API FAQ, 2026). Kontroller FAQ'en for nulstillingskadence og grænser, som varierer efter model.

Understøtter Qwen Image 3 Pro billedredigering?

Redigering håndteres af et separat slutpunkt kaldet Qwen-Image Edit, som understøtter multi-billed-IO, tekstredigering i billeder, tilføjelse, fjernelse og flytning af objekter samt ændringer i positur (Qwen-Image Edit API, 2026). Tekst-til-billede- og redigerings-API'erne har forskellige anmodningsformer.

Konklusion

Du har nu den fulde vej til dit første qwen-image-3.0-pro-kald: en API-nøgle fra Model Studio-konsollen, miljøvariablen DASHSCOPE_API_KEY indlæst, en fungerende cURL-anmodning og et Python-snippet, der parser og downloader resultatet. Prismodellen pr. billede, startende fra $0.075 på Alibabas officielle prissætning, gør omkostningerne forudsigelige, når du skalerer.

To næste skridt vil skærpe din integration. Først skal du bekræfte de nøjagtige anmodnings- og svarfeltnavne mod den officielle API-reference på Qwen API via DashScope, da skemadetaljer kan ændre sig mellem modelversioner. For det andet, hvis dit produkt har brug for redigeringer snarere end ren generering, skal du udforske Qwen-Image Edit API, som låser op for fjernelse af objekter, tekstredigering og positurændringer gennem et dedikeret slutpunkt.

Byg småt, hold øje med din kvote, og send.