API referansı

Qwen API belgeleri

Kimlik doğrulama, Qwen görsel üretimi, eşzamansız görevler, model kimlikleri ve hatalar için kısa referans.

API anahtarı oluştur Modeller

Hızlı başlangıç

API, HTTPS üzerinden standart JSON kullanır. Anahtar oluşturun, üretim gönderin ve görev kimliğini sorgulayın.

01
Bearer anahtarı oluştur
02
Üretim isteği gönder
03
Görev kimliğini sorgula

Temel URL

Tüm herkese açık API istekleri qwenapi.org alan adını kullanır.

https://qwenapi.org

Kimlik doğrulama

Her oluşturma, durum ve geçmiş isteğinde Qwen API anahtarınızı Authorization başlığında gönderin.

Authorization: Bearer $QWEN_API_KEY

API anahtarlarını sunucuda tutun. Tarayıcı paketlerinde, açık depolarda veya istemci loglarında göstermeyin.

Görsel oluştur

Desteklenen canlı model kimliğini ve modele özgü girdi alanlarını gönderin.

POST/api/v1/images/generations

curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3",
    "prompt": "Editorial product photo in soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

Kabul yanıtı

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n86...qw3",
    "status": "IN_PROGRESS"
  }
}

Görev durumunu al

İlerleme, hatalar ve son çıktı URL'leri için görev kimliğini kullanın.

GET/api/v1/tasks/:task_id

curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $QWEN_API_KEY"

IN_PROGRESS

Backend görevi kabul etti ve işliyor.

SUCCESS

Çıktı URL'leri hazır.

FAILED

Görev yapılandırılmış bir hatayla durdu.

Canlı model kimlikleri

Yalnızca bu kimlikler şu anda faturalandırmalı üretim rotalarına gider.

Model	Maliyet	Girdi	Çıktı
qwen-image-3	10 credits / image	Text, up to 3 images	PNG or JPEG
qwen2-image	10 credits / image	Text or image	PNG or JPEG
qwen-image-2512	5 credits / image	Text or images	PNG, JPEG, WebP
qwen-multi-angles	5 credits / image	1-3 images	PNG or JPEG
qwen-layered	10 credits / layer	Image and instruction	Layer images

Hatalar

HTTP durum kodları yapılandırılmış JSON hatalarıyla döner. Destek için görev kimliğini saklayın.

400invalid_requestModel kimliğini ve istek alanlarını doğrulayın.

401unauthorizedBearer anahtarının mevcut ve etkin olduğunu kontrol edin.

402insufficient_creditsFaturalandırma panelinden kredi ekleyin.

404not_foundGörev kimliğinin bir Qwen rotasına ait olduğunu doğrulayın.

429rate_limitedGeri çekilme ve jitter ile yeniden deneyin.

500server_errorDaha sonra tekrar deneyin ve destek için görev kimliğini saklayın.