DEV Community

Cover image for Qwen 3.7 Plus API Nasıl Kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Qwen 3.7 Plus API Nasıl Kullanılır?

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 fiyatlandırma. Yalnızca API olarak sunulduğu için entegrasyon tarafında üç soru öne çıkar: API anahtarı nasıl alınır, ilk istek nasıl gönderilir ve görsel/video kullanımı maliyeti nasıl etkiler?

Apidog'u bugün deneyin

Bu rehberde Qwen 3.7 Plus'a erişimi, API anahtarı oluşturmayı, Python, curl ve JavaScript ile ilk isteği göndermeyi, çok modlu yük formatını, örnek maliyet hesaplamalarını ve hız limitlerini uygulamalı olarak ele alacağız. İstekleri test etmek, ham yanıtları incelemek ve geliştirme sırasında uç noktayı taklit etmek için Apidog kullanabilirsiniz. Önce modelin yeteneklerini ve kıyaslamalarını görmek isterseniz Qwen 3.7 Plus genel bakış yazısından 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 üzerinden OpenAI uyumlu bir uç noktada çalışır. Bölgenize göre bir base_url seçer, API anahtarınızı Bearer token olarak gönderir ve qwen3.7-plus model kimliğiyle /chat/completions çağrısı yaparsınız.

Çok modlu isteklerde mesaj içeriğine görsel veya video parçaları eklersiniz. Fiyatlandırma milyon girdi tokenı başına 0,40 ABD doları, milyon çıktı tokenı başına 1,60 ABD doları ve önbelleğe alınmış girdi için 0,08 ABD dolarıdır. Qwen3.7-Max'e göre girdi tarafında yaklaşık altı kat daha ucuzdur. Sürekli ücretsiz katman yoktur; yeni hesaplar tek seferlik ücretsiz kota alabilir. Görsel ve video tokenleri aynı bağlam bütçesini kullandığı için medya ağırlıklı istekler maliyeti artırır.

Üretime geçmeden önce Model Studio belgelerindeki güncel model kimliğini ve bölgeye ait uç noktayı doğrulayın.

Qwen 3.7 Plus'a nasıl erişilir?

Qwen 3.7 Plus için iki pratik erişim yüzeyi vardır.

Qwen 3.7 Plus erişim arayüzü

1. Qwen Chat ile hızlı değerlendirme

chat.qwen.ai üzerinden oturum açıp Plus modelini seçebilirsiniz. Bir ekran görüntüsü yükleyerek modelin görsel anlama veya GUI-grounding davranışını hızlıca test edebilirsiniz.

Bu yöntem entegrasyon için uygun değildir; yalnızca manuel değerlendirme içindir.

2. Alibaba Cloud Model Studio ile API entegrasyonu

Üretim entegrasyonu için Alibaba Cloud Model Studio, yani DashScope kullanılır. Qwen 3.7 Plus, OpenAI uyumlu bir API üzerinden sunulduğu için mevcut OpenAI SDK tabanlı kodlarda çoğu zaman yalnızca şu iki değeri değiştirmeniz yeterlidir:

  • base_url
  • api_key

Önemli sınırlama: Qwen 3.7 Plus tescilli bir modeldir. Açık ağırlıklar sunulmaz; bu nedenle kendi sunucunuzda barındıramaz veya air-gapped bir ortamda çalıştıramazsınız. Bu sınırlamanın ayrıntıları için Qwen 3.7 Plus genel bakış yazısına bakabilirsiniz.

Yöntem API erişimi Maliyet En iyi kullanım
Qwen Chat (chat.qwen.ai) Hayır Ücretsiz, hız limitli Görselli 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

API erişimi Alibaba Cloud hesabı üzerinden yapılır.

  1. Alibaba Cloud hesabı oluşturun.
  2. Model Studio konsolunu açın: modelstudio.console.alibabacloud.com
  3. Hesabınız ve seçtiğiniz bölge için Model Studio'yu etkinleştirin.
  4. API anahtarları bölümünden yeni bir anahtar oluşturun.
  5. Anahtarı bir kez kopyalayın ve parola gibi saklayın.

Anahtarlar bölgeye özeldir. Örneğin Singapur bölgesinde oluşturulan bir anahtar, Pekin uç noktasında kimlik doğrulaması yapmaz.

Bölgeye göre temel URL'ler:

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 koda yazmayın. 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"
Enter fullscreen mode Exit fullscreen mode

Uygulama içinde anahtarı şu şekilde okuyun:

echo $DASHSCOPE_API_KEY
Enter fullscreen mode Exit fullscreen mode

İlk isteğiniz: Python, curl ve JavaScript

Uç nokta OpenAI uyumlu olduğu için OpenAI SDK'sını DashScope base_url değeriyle kullanabilirsiniz. Model kimliği bu rehberde qwen3.7-plus olarak kullanılmıştır; ancak model tanımlayıcıları değişebileceğinden dağıtımdan önce Model Studio model listesindeki güncel değeri kontrol edin.

Python ile istek gönderme

Kurulum:

pip install openai
Enter fullscreen mode Exit fullscreen mode

Kod:

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)
Enter fullscreen mode Exit fullscreen mode

curl ile istek gönderme 

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."
      }
    ]
  }'
Enter fullscreen mode Exit fullscreen mode

JavaScript ile istek gönderme

Kurulum:

npm install openai
Enter fullscreen mode Exit fullscreen mode

Kod:

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);
Enter fullscreen mode Exit fullscreen mode

Görsel gönderme

Qwen 3.7 Plus'ı Qwen 3.7 Max yerine kullanmanın ana nedeni çok modlu girdidir. Görsel içeriği, mesajın content alanında bir dizi parçası olarak gönderirsiniz.

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"
                    }
                },
            ],
        }
    ],
)

print(resp.choices[0].message.content)
Enter fullscreen mode Exit fullscreen mode

Görseli iki şekilde gönderebilirsiniz:

  • Genel erişilebilir bir URL
  • Base64 veri URI'si

Base64 örneği:

import base64
from pathlib import Path

image_bytes = Path("screenshot.png").read_bytes()
image_base64 = base64.b64encode(image_bytes).decode("utf-8")

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Ekrandaki birincil CTA düğmesini bulun."
                },
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/png;base64,{image_base64}"
                    }
                },
            ],
        }
    ],
)
Enter fullscreen mode Exit fullscreen mode

Bu yapı GUI-grounding iş akışları için kullanışlıdır. Örneğin modele bir ekran görüntüsü verip şu tür yapılandırılmış yanıtlar isteyebilirsiniz:

click at (x=487, y=232)
Enter fullscreen mode Exit fullscreen mode

Video gönderme

Video girdileri de benzer bir çok modlu yük yapısını izler. Ancak video alanlarının kesin adları ve desteklenen biçimler bölgeye veya güncel API uyumluluk şemasına göre değişebilir. Bu nedenle üretimden önce DashScope OpenAI uyumluluk belgelerini kontrol edin.

Uygulamada video kullanırken şu kuralları uygulayın:

  • Gereksiz kareleri göndermeyin.
  • Videoyu düşük FPS ile örnekleyin.
  • Yalnızca görev için gerekli zaman aralığını gönderin.
  • Çözünürlüğü gereksiz yere yüksek tutmayın.

Çünkü video kareleri de tokenlere dönüştürülür ve aynı 1M bağlam bütçesini kullanır.

Fiyatlandırma

Qwen 3.7 Plus, uygun fiyatlı çok modlu katman olarak konumlanır. Qwen 3.7 Max ile karşılaştırma:

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, Qwen 3.7 Plus'ın girdi tarafında Max'e göre yaklaşık altı kat daha ucuz olduğu anlamına gelir.

Sürekli ücretsiz bir katman yoktur. Yeni Model Studio hesapları, kullandıkça öde faturalandırmaya geçmeden önce modeli değerlendirmek için tek seferlik ücretsiz token kotası alabilir. Bu kota genellikle Singapur bölgesiyle ilişkilidir.

Eski Qwen OAuth ücretsiz yolunun 15 Nisan 2026'da kullanımdan kaldırıldığını unutmayın; yeni entegrasyonları bunun üzerine kurmayın.

Resmi rakamlar için:

Daha geniş aileyi ücretsiz denemek için Qwen 3.7'yi ücretsiz kullanma rehberine bakabilirsiniz.

İstek maliyeti nasıl hesaplanır?

Metin istekleri genellikle ucuzdur. Maliyet çoğunlukla görsel ve video girdileriyle artar. Çünkü medya içeriği tokenlere dönüştürülür ve standart girdi oranı üzerinden ücretlendirilir.

Örnek hesaplama:

İ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ı

Bu değerler yaklaşık değerlerdir. Gerçek maliyet çözünürlük, örnekleme hızı, istem uzunluğu ve çıktı uzunluğuna göre değişir.

Pratik optimizasyonlar:

  • Ekran görüntülerini küçültün.
  • Gereksiz kenar boşluklarını kırpın.
  • Video için düşük FPS kullanın.
  • Uzun videoyu parçalara bölün.
  • Aynı sistem istemlerini önbelleğe alınabilir yapıda tutun.
  • Yanıt uzunluğunu sınırlayın.

Daha geniş maliyet stratejileri için ajan token maliyetlerini azaltma ve Plus'ı bu fiyat noktasına getiren 2026 Çin LLM fiyat savaşı notlarına bakabilirsiniz.

Hız limitleri ve hata yönetimi

Model Studio, hesap başına dakikadaki istek ve dakikadaki token bazında hız limitleri uygular. Sabit tek bir global limit yoktur; limitler hesap katmanınıza ve bölgenize göre değişebilir.

Mevcut limitleri görmek için Model Studio konsolundaki kota sayfasını kontrol edin. Limitlere ulaşıyorsanız aynı sayfadan artırım talep edebilirsiniz.

Yaygın hata kodları:

Hata Olası neden Çözüm
401 Unauthorized Yanlış anahtar veya yanlış bölge uç noktası Anahtarın bölgesini ve base_url değerini kontrol edin
429 Too Many Requests Hız limitine ulaşıldı Exponential backoff ile yeniden deneyin
400 Bad Request Hatalı çok modlu yük, büyük görsel veya bağlam taşması Payload şemasını, medya boyutunu ve token bütçesini kontrol edin
5xx Servis tarafı geçici hata Kısa bekleme ve yeniden deneme uygulayın

Basit retry örneği:

import time
from openai import OpenAI

def call_with_retry(client: OpenAI, payload: dict, max_retries: int = 5):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(**payload)
        except Exception as exc:
            wait = min(2 ** attempt, 30)

            # Gerçek uygulamada hata tipini/status code'u ayrıştırın.
            if attempt == max_retries - 1:
                raise

            print(f"Hata alındı, {wait} saniye sonra yeniden deneniyor: {exc}")
            time.sleep(wait)
Enter fullscreen mode Exit fullscreen mode

Üretim uygulamasında özellikle şu kontrolleri ekleyin:

  • Görsel boyutu limiti
  • Video süresi limiti
  • Maksimum çıktı token sınırı
  • 429 ve 5xx için retry
  • 400 hatalarında payload loglama
  • Bölge ve model kimliği doğrulama

API'yi Apidog ile test edin ve taklit edin

Çok modlu isteklerde hata yapmak kolaydır. Görselleri base64 ile kodlarsınız, content dizilerini iç içe yerleştirirsiniz ve çoğu zaman yapılandırılmış eylem planlarını geri okursunuz. Bunu yalnızca terminalde doğrulamak hızlıca zorlaşır.

Apidog ile API testi

Apidog ile Qwen 3.7 Plus isteklerini tek bir çalışma alanında test edebilirsiniz:

  • Metin, görsel ve video parçaları içeren istekler oluşturun.
  • Ham JSON yanıtını inceleyin.
  • Model Studio anahtarını ortam değişkeni olarak saklayın.
  • Farklı bölgeler için ayrı ortamlar tanımlayın.
  • Ön uç geliştirilirken API uç noktasını mock olarak çalıştırın.
  • Hatalı payload'ları hızlıca karşılaştırın.

Plus'ı GUI veya CLI ajan akışlarında kullanıyorsanız, araç çağrıları zincir halinde ilerler. Bu durumda Apidog'un AI ajan hata ayıklayıcısı, çalıştırmanın hangi adımda bozulduğunu görmenize yardımcı olur.

Qwen 3.7 Plus API'sini üretime bağlamadan önce test etmek, hata ayıklamak ve mocklamak için Apidog'u indirin.

SSS

Qwen 3.7 Plus API için ücretsiz katman var mı?

Sürekli ücretsiz katman yoktur. Yeni Alibaba Cloud Model Studio hesapları, genellikle Singapur bölgesinde, değerlendirme için tek seferlik ücretsiz token kotası alabilir. Sonrasında faturalandırma kullandıkça öde modeline geçer.

Model kimliği nedir?

Bu rehberde model kimliği qwen3.7-plus olarak kullanılmıştır. Tanımlayıcılar değişebileceğinden üretime geçmeden önce Model Studio model listesindeki güncel değeri doğrulayın.

Görsel ve video maliyeti nasıl hesaplanır?

Görsel ve video içeriği tokenlere dönüştürülür ve standart girdi oranı üzerinden ücretlendirilir. Bir 1080p ekran görüntüsü birkaç bin tokene mal olabilir. Video ise örneklenen kare sayısına göre hızla daha pahalı hale gelir.

API, Qwen 3.7 Max'ten nasıl farklı?

API yapısı ve OpenAI uyumlu uç noktalar benzerdir. Qwen 3.7 Plus, mesaj içeriğinde görsel ve video parçalarını kabul eder ve yaklaşık altı kat daha ucuzdur. Qwen 3.7 Max yalnızca metin tabanlıdır ve saf metin kıyaslamalarında küçük bir avantaja sahiptir.

Qwen 3.7 Plus'ı kendi sunucumda barındırabilir miyim?

Hayır. Model ağırlıkları kapalıdır. Qwen 3.7 Plus yalnızca Alibaba Cloud Model Studio üzerinden kullanılabilir.

Hangi temel URL'yi kullanmalıyım?

API anahtarını oluşturduğunuz bölgeye ait temel URL'yi kullanmalısınız:

  • 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

Farklı bölgedeki bir anahtar, başka bir bölgenin uç noktasında çalışmaz.

Sonuç

Qwen 3.7 Plus entegrasyonu, OpenAI SDK'sında base_url ve API anahtarını değiştirip qwen3.7-plus modeliyle /chat/completions çağrısı yapmaktan ibarettir. Görsel veya video gerektiğinde mesaj içeriğine ilgili parçaları eklersiniz.

Metin tarafında maliyet düşüktür; asıl maliyet medya girdileriyle büyür. Bu nedenle üretim öncesi en önemli optimizasyon, kaç piksel ve kaç kare gönderdiğinizi kontrol etmektir.

Bir API anahtarı oluşturun, ilk metin isteğini gönderin, ardından küçük bir ekran görüntüsüyle çok modlu akışı test edin. Üretime geçmeden önce payload'ları, yanıtları ve hata senaryolarını Apidog içinde doğrulayın.

Top comments (0)