DEV Community

Cover image for Hy3 Önizleme API'si Ücretsiz Nasıl Kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Hy3 Önizleme API'si Ücretsiz Nasıl Kullanılır?

Tencent, Hy3 Preview'u 22 Nisan 2026'da açık kaynak olarak yayınladı ve hemen ardından OpenRouter, bu modeli tamamen ücretsiz bir uç nokta olarak listeledi. Kredi kartı gerekmez, jeton ölçümü veya deneme süresi yok. Tencent'in Yuanbao ve CodeBuddy sistemlerinde çalışan aynı 295B-parametre Uzman Karışımı (Mixture-of-Experts) modelini, bugün kendi projelerinizde sıfır maliyetle kullanabilirsiniz.

Bugün Apidog'u deneyin

Bu rehberde, Hy3 Preview API'sini OpenRouter, Hugging Face Space ve orijinal Hy3 deposu üzerinden ücretsiz olarak nasıl kullanacağınızı adım adım göreceksiniz. Ayrıca Hy3'ün benzersiz akıl yürütme modları ve Apidog ile kod yazmadan API testi yapmanın pratik yollarını da bulabilirsiniz.

Hızlı başlamak için doğrudan “Adım adım: OpenRouter'da Hy3 Preview'ı ücretsiz çağırın” bölümüne geçebilirsiniz.

TL;DR

  • Hy3 Preview, OpenRouter'da tencent/hy3-preview:free modeliyle tamamen ücretsizdir (0$ giriş/çıkış).
  • Mixture-of-Experts modeli: 295B toplam, 21B aktif parametre, 192 uzman, 256K jeton bağlam penceresi.
  • Üç akıl yürütme modu: Hızlı yanıtlar için no_think, derin analiz için low ve high.
  • Kıyaslamalar: SWE-bench Verified 74.4, Terminal-Bench 2.0 54.4, GPQA Diamond 87.2, MMLU 87.42.
  • Üç ücretsiz yol: OpenRouter, Hugging Face Hy3-preview Alanı, vLLM ile kendi kendine barındırma.
  • Apidog uyumluluğu: OpenAI Sohbet Tamamlama şemasıyla, OpenRouter API'siyle doğrudan çalışır.

Hy3 Preview nedir?

Hy3 Preview, Tencent'in yeni nesil Hunyuan temel model ekibinin amiral gemisidir. Ekip, eski OpenAI araştırmacısı Yao Shunyu liderliğinde, şirketin akıl yürütme yeteneklerini geliştirmeye odaklandı. Hy3, güçlü ajansiyel eğitim ve araç kullanım kabiliyetiyle öne çıkar; DeepSeek, Alibaba ve Zhipu gibi diğer Çin menşeli açık ağırlıklı modellere doğrudan rakiptir.

Resmi model kartı'nda teknik detaylar:

  • Mimari: 80 katman, Mixture-of-Experts, 64 başlı dikkat, ekstra MTP katmanı.
  • Parametreler: 295B toplam, her ileri geçişte 21B aktif.
  • Uzmanlar: Her jetonda 192 uzman, en iyi 8 yönlendirme.
  • Bağlam: 256K jeton (OpenRouter: 262.144).
  • Tokenlayıcı: BF16, 120.832 kelime dağarcığı.
  • Lisans: Tencent Hy Topluluk Lisansı, ticari kullanım mümkün.

Model, çok turlu araç kullanımı ve RL ile eğitildiği için kod ve kabuk görevlerinde üst seviye sonuçlar verir. SWE-bench Verified, Terminal-Bench 2.0 ve şirket içi WildClawBench skorları, Hy3'ü kodlama alanında öne çıkarır.

Hy3 Preview'u kullanmanın üç ücretsiz yolu

Hy3 Preview'u aşağıdaki yollarla ücretsiz çalıştırabilirsiniz:

Yol Ne olduğu Ücretsiz mi? Ne için iyi?
OpenRouter tencent/hy3-preview:free Barındırılan OpenAI uyumlu API Evet, 0$ giriş/çıkış Aracılar, betikler, arka uç entegrasyonlar
Hugging Face Space Tarayıcı sohbet demosu Evet Hızlı istemler, demo/test
Kendi kendine barındırma (vLLM / SGLang) Açık ağırlıkları kendi GPU'larınızda çalıştırın Ücretsiz yazılım, donanım maliyeti Gizlilik, yüksek hacimli iş yükleri

Çoğu geliştirici için en hızlı ve kolay yol OpenRouter API'sini kullanmaktır. Ücretsiz katmandaki hız ve kapasite, prototipleme için yeterli.

Adım adım: OpenRouter'da Hy3 Preview'ı ücretsiz çağırın

İşte sıfırdan çalışan bir tencent/hy3-preview:free API isteği oluşturmanın en kısa yolu:

  1. OpenRouter hesabı oluşturun: openrouter.ai üzerinden e-posta ile kaydolun. Ücretsiz katman için ödeme yöntemi gerekmez.
  2. API anahtarı alın: OpenRouter panelinden yeni bir anahtar oluşturun, örneğin export OPENROUTER_API_KEY=sk-or-... ile ortam değişkeni olarak saklayın.
  3. Model sayfasını kontrol edin: Hy3 Preview ücretsiz listelemesine gidin, "Ücretsiz" banner'ını görün ve kullanım limitini kontrol edin.

İlk API çağrınızı yapın: OpenRouter, OpenAI Sohbet Tamamlama API şemasını destekler. Herhangi bir OpenAI SDK veya doğrudan cURL ile aşağıdaki gibi çağırabilirsiniz:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tencent/hy3-preview:free",
    "messages": [
      {"role": "user", "content": "Explain the MoE routing decision inside a top-8 of 192 setup in 3 sentences."}
    ],
    "temperature": 0.9,
    "top_p": 1.0
  }'
  1. Akıl yürütme modunu etkinleştirin: reasoning parametresi ile effort: "low" veya effort: "high" ayarlayarak daha derin analiz alabilirsiniz. reasoning_details alanı ile detayları görebilirsiniz:
{
  "model": "tencent/hy3-preview:free",
  "messages": [
    {"role": "user", "content": "Plan, then write a Bash script that rotates daily log files older than 30 days into a dated archive folder."}
  ],
  "reasoning": {"effort": "high"}
}
  1. Oturumu devam ettirin: Kod tabanı veya uzun konuşmalar için thread içinde devam edin; 256K pencere çoğu senaryoya yeter.

Bu adımlarla, Hugging Face'te yayınlanan modelle aynı Hy3 Preview'a, tamamen ücretsiz şekilde API üzerinden ulaşabilirsiniz.

Ücretsiz, Artı ve kendi kendine barındırma: farkları nelerdir

Yetenek OpenRouter Ücretsiz OpenRouter Ücretli Kendi Kendine Barındırma
Jeton başına maliyet 0$ Sağlayıcıya göre Elektrik + GPU
Akıl yürütme modları no_think, low, high Aynı Aynı
Bağlam uzunluğu 256K 256K 256K (donanım yeterliyse)
Yük altında performans Paylaşımlı, öncelik düşük Özel Kendi altyapınız
Hız limitleri OpenRouter ücretsiz sınırı Sağlayıcıya özel Yok
Veri saklama OpenRouter politikası Sağlayıcıya özel Kendi donanımınızda
Akıl yürütme detayları Evet (reasoning_details) Evet Evet

Ücretsiz katman; prototip, yan proje, düşük trafikli API ve kıyaslamalar için idealdir. Yüksek hacim, düşük gecikme veya veri gizliliği gerekiyorsa ücretli ya da kendi kendine barındırma seçeneklerini değerlendirin.

Hy3'ten daha fazla verim almanızı sağlayan istem ve parametre ipuçları

  • Sıcaklığı moda göre ayarlayın: Yaratıcı işler için temperature=0.9, yapılandırılmış çıktı için 0.3 önerilir.
  • Günlük konuşmalar için no_think kullanın: Yalnızca planlama veya çok adımlı kod için low / high seçin.
  • Sistem mesajında araçları açıkça tanımlayın: Her aracın işlevini belirtin; çıktılar daha iyi olur.
  • Kodu özetletmek yerine doğrudan verin: 256K pencereyi kullanarak dosyaları yapıştırıp, doğrudan analiz veya düzenleme isteyin.
  • Çoklu dosya düzenleme: Tüm düzenlenecek dosyaları tek mesajda topluca gönderin.
  • İki aşamalı istem: "Önce plan hazırla, onayımı bekle, sonra uygula" gibi prompt zincirleri genelde daha stabil ve temiz sonuçlar üretir.

Yayınlamadan önce bilmeniz gereken sınırlamalar

  • Hız limitleri yükle değişir: Ücretsiz havuzda 429 hatası alırsanız, exponential backoff ile tekrar deneyin.
  • Akıl yürütme jetonları çıktı olarak sayılır: reasoning_details ücretsiz katmanda ücretsiz, ama ücretli uç noktalarda faturalandırılır.
  • Lisans açık kaynak değildir (Apache 2.0 değil): Ticari kullanım için lisansı mutlaka okuyun.
  • Araç çağrısı için doğru ayrıştırıcı gerekir: vLLM/SGLang ile kullanıyorsanız --tool-call-parser hy_v3 (veya hunyuan) ekleyin.
  • Dil desteği: İngilizce ve Çince birinci sınıf, diğer dillerde kalite düşer.
  • Bazı akıl yürütme kıyaslamalarında ABD modellerinin gerisinde: Hy3, Çin modelleriyle başa baş, ancak en zor benchmarklarda OpenAI/Google DeepMind'ın gerisinde kalıyor.

Geliştirici için hızlı yol: Hy3 Preview artı Apidog

CLI ve cURL ile hızlı test edebilirsiniz. Daha üretken ve görsel bir API testi için Apidog kullanmak çok daha verimlidir.

  1. Apidog'da yeni bir proje oluşturun. OpenAI Sohbet Tamamlama OpenAPI spesifikasyonunu içe aktarın.
  2. Temel URL olarak https://openrouter.ai/api/v1 ekleyin. OPENROUTER_API_KEY değişkenini girin.
  3. /chat/completions endpoint'ine, model olarak tencent/hy3-preview:free ile istek oluşturun.
  4. Akıl yürütme modlarını karşılaştırmak için isteği forkladın; aynı prompt ile no_think, low, high farkını görebilirsiniz.
  5. İstem şablonlarını kaydedin. Apidog'un ortam/değişken sistemiyle sistem mesajları, araç şemaları ve kullanıcı promptlarını ayrı ayrı yönetip tekrar kullanın.

Postman'den geçiş yapmak isterseniz, 2026'da Postman olmadan API testi kılavuzuna göz atabilirsiniz. Ayrıca VS Code eklentisi ile VS Code içinde Apidog entegrasyonunu da kullanabilirsiniz.

Sınıra ulaştığınızda ücretsiz alternatifler

OpenRouter ücretsiz havuzunda kapasiteye takılırsanız:

Bu modeller Hy3'ün kodlama/danışman skorlarını yakalayamayabilir, ancak ücretsiz katmanın öncelik vermediği sohbet, çok dilli ve multimodal senaryolarda avantaj sağlar. Apidog ile model başına koleksiyon oluşturarak, gerçek promptlarınızda yan yana test edebilirsiniz.

Hy3 Preview'ı vLLM ile kendi kendine barındırma

Kendi GPU altyapınız varsa, Hy3 Preview'u vLLM ile şu şekilde çalıştırabilirsiniz:

vllm serve tencent/Hy3-preview \
  --tensor-parallel-size 8 \
  --speculative-config.method mtp \
  --speculative-config.num_speculative_tokens 1 \
  --tool-call-parser hy_v3 \
  --reasoning-parser hy_v3 \
  --enable-auto-tool-choice \
  --served-model-name hy3-preview

SGLang için --tool-call-parser hunyuan ve --reasoning-parser hunyuan parametrelerini kullanın. Sunucu http://localhost:8000/v1 adresinde çalışacak, OpenAI SDK'ları ile doğrudan entegre edebilirsiniz (temel URL ve anahtar değişir).

Modelin tam sürümü için BF16 modunda sekiz adet H100 sınıfı GPU gereklidir. Kuantize sürümler ileride çıkabilir, fakat başlangıçta tam hassasiyet desteklenir.

Sıkça Sorulan Sorular

Hy3 Preview ücretsiz mi? Evet. OpenRouter tencent/hy3-preview:free modelinde giriş ve çıkış jetonları için 0$ fiyatlandırma uygular. Akıl yürütme jetonları da ücretsizdir; sadece hız limiti uygulanır. Güncel durumu OpenRouter model sayfasından kontrol edin.

Hy3 Preview, DeepSeek V3 ve Qwen 3 ile nasıl karşılaştırılır? Hy3 Preview'ın SWE-bench ve Terminal-Bench skorları, onu Çin modelleri arasında öne çıkarır. Kodlama ve araç kullanımı için RL tabanlı avantajı var. Sohbet için Qwen 3 ve DeepSeek V3 rekabetçidir.

Hy3'ün akıl yürütme modları nedir? Üç mod: no_think (varsayılan), low ve high. OpenRouter'da reasoning parametresi ile veya doğrudan çağrıda chat_template_kwargs={"reasoning_effort": "high"} ile seçebilirsiniz.

Hy3 Preview'ı ticari olarak kullanabilir miyim? Evet, Tencent Hy Topluluk Lisansı ile ticari kullanıma uygundur. Detaylı şartlar için Hy3 GitHub deposunu inceleyin.

Ücretsiz katman ne kadar bağlam uzunluğunu destekler? 256K jetona kadar çıkabilir (OpenRouter: 262.144). Orta ölçekli bir kod tabanının tamamını ve geçmişi aynı anda işleyebilirsiniz.

Hy3 Preview'ı kod yazmadan nasıl test ederim? Hugging Face Space ile sohbet demosu veya Apidog üzerinden OpenRouter API'sini görsel olarak test edebilirsiniz. 3 temel ayar yeterli: temel URL, API anahtarı ve model adı.

Top comments (0)