Qwen 3.7 Plus, Alibaba'nın çok modlu ajan modelidir: metin, görsel ve video girişi, 1 milyon token bağlamı ve uygun bir fiyat. Yalnızca bir API olarak sunulduğu için pratik sorular hemen ortaya çıkar. Anahtarı nasıl alırım, bir görseli nasıl gönderirim ve maliyeti nedir? Bu rehber, bu üç soruyu da yanıtlar.
Erişimi, anahtar almayı, Python, curl ve JavaScript'teki ilk isteğinizi, çok modlu yük formatını, örnek maliyet hesaplamalarıyla tam fiyatlandırma dökümünü ve hız limitlerini ele alacağız. Bu süreçte Apidog'u kullanarak test istekleri gönderecek, ham yanıtları inceleyecek ve uygulamanızın geliştirmeye devam etmesi için uç noktayı taklit edeceksiniz. Önce yetenekleri ve kıyaslamaları öğrenmek isterseniz, Qwen 3.7 Plus genel bakış yazımızdan başlayın; yalnızca metin amiral gemisi için ise temel Qwen 3.7 API rehberine bakın.
TL;DR
Qwen 3.7 Plus, Alibaba Cloud Model Studio aracılığıyla OpenAI uyumlu bir uç noktada çalışır. Bir bölge taban URL'si ayarlarsınız, anahtarınızı bir Bearer token olarak iletirsiniz ve `qwen3.7-plus` model kimliğiyle `/chat/completions` çağrısı yaparsınız. Çok modlu istekler, mesaj içeriğine görsel veya video kısımları ekler. Fiyatlandırma, milyon girdi tokenı başına 0,40 ABD doları ve milyon çıktı tokenı başına 1,60 ABD dolarıdır; önbelleğe alınmış girdi ise 0,08 ABD dolarıdır ve Qwen3.7-Max'ten yaklaşık altı kat daha ucuzdur. Sürekli ücretsiz bir katman yoktur, ancak yeni hesaplar tek seferlik ücretsiz bir kota alır. Görsel tokenler bağlam bütçesini paylaşır, bu nedenle görseller ve videolar faturanızı yükseltir. Dağıtımdan önce Model Studio belgelerindeki tam model kimliğini onaylayın.
Qwen 3.7 Plus'a nasıl erişilir?
İlk günlerini yalnızca sohbet önizlemesi arkasında geçiren metin amiral gemisinin aksine, Plus ilk günden itibaren ticari bir API'dir. İki yüzey önemlidir.
Qwen Chat (chat.qwen.ai). Plus'ı bir görselle denemenin en hızlı yolu. Oturum açın, Plus modelini seçin, bir ekran görüntüsü bırakın ve nasıl çalıştığını görün. Bu, entegrasyon için değil, değerlendirme içindir.
Alibaba Cloud Model Studio (DashScope). Bu gerçek API'dir. Model Studio, Plus'ı OpenAI uyumlu bir uç nokta aracılığıyla sunar, böylece OpenAI SDK'sı ile çalışan herhangi bir kod, bir taban URL ve anahtar değişimi ile onu çağırabilir.
Göz önünde bulundurulması gereken önemli bir sınırlama: Plus tescillidir. İndirilecek açık ağırlıklar yoktur, bu nedenle kendi kendine barındıramaz veya hava boşluklu bir ortamda çalıştıramazsınız. Eğer bu bir gereksinimse, Qwen 3.7 Plus genel bakış yazımız bu durumu ayrıntılı olarak ele almaktadır.
| Yöntem | API erişimi | Maliyet | En iyisi |
|---|---|---|---|
| Qwen Chat (chat.qwen.ai) | Hayır | Ücretsiz, hız limitli | Görsel içeren hızlı değerlendirme |
| Model Studio (DashScope) | Evet, OpenAI uyumlu | Token başına ödeme | Üretim entegrasyonu |
| Kendi kendine barındırma | Hayır | Yok | Mevcut değil; ağırlıklar kapalıdır |
Qwen 3.7 Plus API anahtarı alma
Erişim bir Alibaba Cloud hesabı üzerinden gerçekleşir.
- Bir Alibaba Cloud hesabı oluşturun ve Model Studio konsolunu (
modelstudio.console.alibabacloud.com) açın. - Hesabınız ve bölgeniz için Model Studio'yu etkinleştirin. Anahtarlar bölgeye özeldir, bu nedenle Singapur anahtarı Pekin'e karşı kimlik doğrulamasını yapmaz.
- API anahtarları bölümünü açın ve bir anahtar oluşturun. `sk-` ile başlayan bir dizeye benzer.
- Bir kez kopyalayın ve bir parola gibi saklayın.
Bölgeniz temel URL'nizi belirler:
| Bölge | Temel URL |
|---|---|
| Singapur | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| ABD (Virginia) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| Pekin (Çin) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
Anahtarı kaynak kontrolünden uzak tutun. Bir ortam değişkeni kullanın:
# macOS / Linux
export DASHSCOPE_API_KEY="sk-anahtarınız-buraya"
# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-anahtarınız-buraya"
İlk isteğiniz: Python, curl ve JavaScript
Uç nokta OpenAI uyumludur, bu nedenle resmi OpenAI SDK'sını DashScope temel URL'sine yönlendirilmiş olarak veya ham bir HTTP çağrısı kullanabilirsiniz. Model kimliği `qwen3.7-plus`'tır, ancak tanımlayıcılar değişebileceğinden, dağıtımdan önce Model Studio model listesindeki geçerli dizeyi onaylayın.
OpenAI SDK'sı ile Python
pip install openai ile kurun, ardından:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DASHSCOPE_API_KEY"],
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)
resp = client.chat.completions.create(
model="qwen3.7-plus",
messages=[{"role": "user", "content": "Qwen 3.7 Plus fiyatlandırma modelini iki cümlede özetleyin."}],
)
print(resp.choices[0].message.content)
curl
curl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.7-plus",
"messages": [{"role": "user", "content": "Qwen 3.7 Plus API'sinden merhaba."}]
}'
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DASHSCOPE_API_KEY,
baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
});
const resp = await client.chat.completions.create({
model: "qwen3.7-plus",
messages: [{ role: "user", content: "Qwen 3.7 Plus API'sinden merhaba." }],
});
console.log(resp.choices[0].message.content);
Görsel ve video gönderme
Plus'ı Max yerine kullanmanın nedeni çok modlu giriştir. Görsel içeriği, OpenAI görsel API'sinin kullandığı aynı şekilde, mesaj `content` dizisinde ek parçalar olarak iletirsiniz.
resp = client.chat.completions.create(
model="qwen3.7-plus",
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "Bu formu hangi düğme gönderir? Piksel koordinatlarını verin."},
{"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
],
}],
)
Bir görseli genel bir URL veya base64 veri URI'si olarak geçirebilirsiniz. Video da aynı deseni bir video kısmı ile takip eder. GUI-grounding davranışını sağlayan şey budur: Plus'a bir ekran görüntüsü verirsiniz ve o, `click at (x=487, y=232)` gibi yapılandırılmış eylemler döndürür. Video için kesin kısım adları bölgeye göre farklılık gösterebilir, bu nedenle mevcut şema için OpenAI uyumluluk belgelerini kontrol edin.
Fiyatlandırma
Plus, uygun fiyatlı çok modlu bir katman olarak fiyatlandırılır. Metin amiral gemisi ile karşılaştırması aşağıdadır.
| Model | Girdi / 1M | Çıktı / 1M | Önbelleğe alınmış girdi / 1M |
|---|---|---|---|
| Qwen 3.7 Plus | 0,40 ABD Doları | 1,60 ABD Doları | 0,08 ABD Doları |
| Qwen 3.7 Max | 2,50 ABD Doları | 7,50 ABD Doları | 0,25 ABD Doları |
Bu, girdi açısından Max'ten yaklaşık altı kat daha ucuzdur. Sürekli ücretsiz bir katman yoktur, ancak yeni Model Studio hesapları, faturalandırma kullandıkça öde sistemine geçmeden önce modeli değerlendirmek için tek seferlik ücretsiz bir token kotası (genellikle Singapur bölgesinde) alır. Eski Qwen OAuth ücretsiz yolunun 15 Nisan 2026'da kullanımdan kaldırıldığını unutmayın, bu yüzden bunun üzerine inşa etmeyin. Resmi rakamlar Model Studio fiyatlandırma sayfasında ve ücretsiz kota rehberinde yer almaktadır; daha geniş aileyi sıfır maliyetle denemek için Qwen 3.7'yi ücretsiz kullanma rehberimize bakın.
İsteklerin gerçek maliyeti nedir?
Metin ucuzdur. Faturanın büyüdüğü yer görselliktedir, çünkü görseller ve videolar aynı token başına oran ve aynı 1M bağlam bütçesini paylaşan tokenlere dönüştürülür. Yüksek çözünürlüklü bir ekran görüntüsü birkaç bin tokene mal olabilir ve video kareleri hızla birikir.
| İstek | Girdi tokenleri | Çıktı tokenleri | Yaklaşık maliyet |
|---|---|---|---|
| Yalnızca metin istemi | 10.000 | 2.000 | ~0,007 ABD Doları |
| Bir 1080p ekran görüntüsü + istem | ~1.500 | 300 | ~0,001 ABD Doları |
| 2 fps'de örneklenmiş 30 sn video | ~77.000 | 500 | ~0,032 ABD Doları |
Kare-token rakamları yaklaşık olup çözünürlüğe ve örnekleme hızına bağlıdır, ancak ders geçerlidir: Plus'taki bir metin ajanı neredeyse hiçbir şeye mal olmazken, video ağırlıklı bir iş yükü çağrı başına 30 kat daha pahalıya mal olabilir. Ekran görüntülerini küçültün ve videoyu dikkatli bir şekilde örnekleyin. Daha geniş maliyet stratejisi için, ajan token maliyetlerini azaltma ve Plus'ı bu fiyata getiren 2026 Çin LLM fiyat savaşındaki notlarımıza bakın.
Hız limitleri ve hatalar
Model Studio, hesap başına dakikadaki istek ve dakikadaki token cinsinden hız limitleri uygular ve tavanlar, tek bir yayınlanmış numara yerine hesap katmanınıza ve bölgenize bağlıdır. Mevcut limitleriniz için konsoldaki kota sayfasını kontrol edin ve onlara ulaşırsanız oradan bir artırım talep edin.
Yaygın hataları ele alın:
- 401 Yetkilendirilmedi: yanlış anahtar veya temel URL'niz için yanlış bölgeden bir anahtar.
- 429 Çok Fazla İstek: hız limitine ulaştınız. Geri çekilin ve üstel gecikmeyle yeniden deneyin.
- 400 Hatalı İstek: genellikle hatalı biçimlendirilmiş çok modlu yük, çok büyük bir görsel veya görsel tokenleri sayıldığında bir bağlam taşması.
Çağrıları 429 ve 5xx hatalarında geri çekilmeyle birlikte bir yeniden denemeye sarın ve göndermeden önce görsel boyutunu doğrulayın.
API'yi Apidog ile test edin ve taklit edin
Çok modlu isteklerde hata yapmak kolaydır. Görselleri base64 ile kodluyor, içerik dizilerini iç içe yerleştiriyor ve genellikle bir araç çağırma döngüsünün içinde yapılandırılmış eylem planlarını geri okuyorsunuz. Bunu bir terminalde gözle kontrol etmek çabucak sıkıcı hale gelir.
Apidog size bunun için gerçek bir çalışma alanı sunar. Qwen 3.7 Plus isteklerini görsel ve video kısımlarıyla gönderin, ham JSON yanıtını inceleyin, Model Studio anahtarınızı ortam başına saklayın böylece asla koda yapıştırmazsınız ve ön uç geliştirilirken uç noktayı taklit edin. Plus, bir GUI-ve-CLI ajan çalıştırmasında araç çağrılarını zincirlerken, Apidog'un AI ajan hata ayıklayıcısı, bir çalıştırmanın nerede kesintiye uğradığını bulmanız için tam diziyi gösterir.
Qwen 3.7 Plus API'sini üretime geçmeden önce test etmek, hata ayıklamak ve taklit etmek için Apidog'u indirin.
SSS
Qwen 3.7 Plus API için ücretsiz bir katman var mı? Sürekli ücretsiz bir katman yok. Yeni Alibaba Cloud Model Studio hesapları, genellikle Singapur bölgesinde, değerlendirme için tek seferlik ücretsiz bir token kotası alır, ardından faturalandırma kullandıkça öde sistemine geçer.
Model kimliği nedir? Model Studio'da `qwen3.7-plus`. Tanımlayıcılar değişebileceğinden, dağıtımdan önce Model Studio model listesindeki mevcut dizeyi onaylayın.
Görsel ve video maliyeti nasıl hesaplanır? Görsel içerik, standart girdi oranı üzerinden faturalandırılan tokenlere dönüştürülür. Bir 1080p ekran görüntüsü birkaç bin tokene mal olabilir ve video, örneklenmiş kare başına token ekler, bu nedenle büyük medya yükleri faturayı belirler.
API, Qwen 3.7 Max'ten nasıl farklı? Aynı OpenAI uyumlu yapı ve temel URL'ler. Plus, mesaj içeriğinde görsel ve video kısımlarını kabul eder ve yaklaşık altı kat daha ucuzdur; Max yalnızca metin tabanlıdır ve saf metin kıyaslamalarında küçük bir avantaja sahiptir.
Qwen 3.7 Plus'ı kendi kendime barındırabilir miyim? Hayır. Ağırlıklar kapalıdır, bu nedenle yalnızca Alibaba Cloud Model Studio aracılığıyla çalışır.
Hangi temel URL'yi kullanmalıyım? Anahtarınızı oluşturduğunuz bölgeye (Singapur, ABD (Virginia) veya Pekin) uygun olanı kullanmalısınız. Bir anahtar, farklı bir bölgenin uç noktasına karşı kimlik doğrulaması yapmaz.
Sonuç
Qwen 3.7 Plus'ı çağırmak, OpenAI SDK'sında bir temel URL ve anahtar değişimi, ayrıca görsellik ihtiyacınız olduğunda görsel veya video kısımlarını eklemekten ibarettir. Metin için fiyatlandırma gerçekten ucuzdur ve görsel yükünüzle birlikte ölçeklenir, bu nedenle disiplin, API'nin kendisinde değil, kaç piksel gönderdiğinizdedir. Bir anahtar alın, ilk çok modlu isteğinizi gönderin ve üretime bağlamadan önce tüm akışı Apidog'da test edin.