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

Tencent, Hy3 Preview'u 22 Nisan 2026'da açık kaynaklı hale getirdi ve bir gün içinde OpenRouter bunu tamamen ücretsiz bir uç nokta olarak listeledi. Kredi kartı yok, jeton ölçümü yok, deneme süresi yok. Tencent'in Yuanbao uygulamasına ve CodeBuddy asistanına güç veren aynı 295B-parametre Uzman Karışımı (Mixture-of-Experts) modelini bugün kendi kodunuzdan sıfır maliyetle çağırabilirsiniz.

Bu kılavuz, Hy3 Preview API'sini OpenRouter, Hugging Face Space ve orijinal Hy3 deposu aracılığıyla ücretsiz olarak nasıl kullanacağınızı gösterir. Ayrıca Hy3'ü çoğu 2026 açık modelinden farklı kılan akıl yürütme modlarını ve tek kullanımlık betikler yazmadan API'yi Apidog içinde nasıl test edeceğinizi de kapsar.

düğme

İlk yanıtınıza en hızlı yoldan ulaşmak isterseniz, “Adım adım: OpenRouter'da Hy3 Preview'ı ücretsiz çağırın” bölümüne atlayın.

TL;DR

• Hy3 Preview, OpenRouter'da `tencent/hy3-preview:free` model kimliği altında, 0$ giriş ve 0$ çıkış fiyatlandırmasıyla ücretsizdir.
• Bu bir Uzman Karışımı (Mixture-of-Experts) modelidir: Toplam 295B parametre, 21B aktif, en iyi 8 yönlendirmeli 192 uzman ve 256K jetonluk bağlam penceresi.
• Üç akıl yürütme modu dahili olarak sunulur: hızlı yanıtlar için `no_think`, aracı ve kodlama görevlerinde derinlemesine düşünce zinciri için `low` ve `high`.
• Açık ağırlıklı bir model için kıyaslamalar güçlüdür: SWE-bench Verified 74.4, Terminal-Bench 2.0 54.4, GPQA Diamond 87.2, MMLU 87.42.
• Üç ücretsiz yolla çalıştırabilirsiniz: OpenRouter ücretsiz katmanı, Hugging Face Hy3-preview Alanı veya vLLM ve açık ağırlıklarla yerel çıkarım.
• Apidog, OpenRouter uç noktasıyla iyi uyum sağlar çünkü Hy3, OpenAI Sohbet Tamamlama şemasını kullanır; OpenRouter'a bir istek gönderin ve başlayın.

Hy3 Preview nedir?

Hy3 Preview, Tencent'in yeniden yapılandırılmış Hunyuan temel model ekibinin ilk amiral gemisi sürümüdür; ekip şu anda şirketin akıl yürütme yığınını geliştirmek için işe aldığı eski bir OpenAI araştırmacısı olan Yao Shunyu tarafından yönetilmektedir. Bunu Tencent'in şimdiye kadarki en yetenekli modeli ve DeepSeek, Alibaba ve Zhipu'dan çıkan önde gelen Çin açık ağırlıklı modellerine doğrudan bir yanıt olarak düşünebiliriz.

Resmi model kartındaki teknik profil, ajana önceliklidir:

• Mimari: Uzman Karışımı (Mixture-of-Experts), 80 katman artı bir MTP katmanı, gruplandırılmış sorgu dikkatine sahip 64 dikkat başlığı.
• Parametreler: Toplam 295B, her ileri geçişte 21B aktif.
• Uzmanlar: Her jeton için en iyi 8 yönlendirmeli 192 uzman.
• Bağlam: 256K jeton (OpenRouter listelemesinde 262.144).
• Tokenlayıcı: BF16 hassasiyetinde 120.832 girişli kelime dağarcığı.
• Lisans: Tencent Hy Topluluk Lisansı, lisans koşulları dahilinde ticari kullanım izni verilmektedir.

Onu genel 200B aralığındaki bir MoE'den ayıran şey, ajansiyel eğitimidir. Tencent, çok turlu araç kullanımı için RL altyapısını yeniden inşa etti ve SWE-bench Verified, Terminal-Bench 2.0 ve şirket içi WildClawBench paketindeki yayınlanan puanlar, onu kod ve kabuk görevlerinde en iyi kapalı modellere yaklaştırmaktadır.

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

Bir sohbet kullanıcı arayüzü, bir API veya yerel ağırlıklar isteyip istemediğinize bağlı olarak üç yolunuz var.

Çoğu geliştirici OpenRouter yolunu tercih edecektir. Kaydolmaktan çalışan bir API çağrısına giden en kısa yoldur ve ücretsiz katmandaki hız limitleri prototipleme için yeterince cömerttir.

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

İşte sıfırdan çalışan bir `tencent/hy3-preview:free` yanıtına giden minimum yol.

1. Bir OpenRouter hesabı oluşturun. openrouter.ai adresinden kaydolun. E-posta yeterlidir; ücretsiz katman modelleri için ödeme yöntemi gerekmez.
2. Bir API anahtarı oluşturun. OpenRouter kontrol panelinde “Anahtarlar”ı açın ve yeni bir anahtar oluşturun. Bunu bir ortam değişkenine kopyalayın, örneğin export OPENROUTER_API_KEY=sk-or-....
3. Model sayfasını açın. Hy3 Preview ücretsiz listelemesine gidin ve durum banner'ının “Ücretsiz” yazdığını onaylayın. Orada kullanım istatistiklerini de göreceksiniz; lansmanda uç nokta, tüm kullanıcılar arasında günde 6.81B istem jetonu işliyordu.

İlk isteğinizi gönderin. OpenRouter, OpenAI Sohbet Tamamlama şemasını sunar, bu nedenle herhangi bir OpenAI SDK'sı çalışır:

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. İhtiyaç duyduğunuzda akıl yürütmeyi etkinleştirin. Hy3, effort değeri low veya high olarak ayarlanmış bir reasoning parametresi kabul eder. OpenRouter, düşünme izini ayrı bir reasoning_details dizisinde döndürür ve bu dizi kendi jeton kotası olarak faturalandırılır:

{
  "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. Tekrarlayın. Modelin önceki bağlam üzerine inşa etmesini istiyorsanız oturumu aynı iş parçacığında tutun; Hy3'ün 256K'lık penceresi çoğu tam kod tabanını uçtan uca yönetir.

Akışın tamamı budur. Çağırdığınız model, Hugging Face'te yayınlanan modelle aynıdır; OpenRouter ücretsiz katmanındaki kalite, diğer sağlayıcılardaki ücretli rotalarla aynıdır.

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

Ücretsiz tek yol değildir ve birine karar vermeden önce gerçek farkları görmek faydalıdır.

Ücretsiz seçenek, prototipler, yan projeler, değerlendirme kıyaslamaları ve düşük trafikli aracılar için doğru seçimdir. Gecikme önemli hale geldiğinde veya hız sınırını aştığınızda ücretli veya kendi kendine barındırma mantıklı olur.

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

Hy3, küçük modellere göre açık kurulumu daha fazla ödüllendirir. Birkaç alışkanlık yardımcı olur.

• Sıcaklığı moda göre eşleştirin. Model kartı, varsayılan olarak temperature=0.9 ve top_p=1.0 değerlerini önerir. Yapılandırılmış çıktılar için 0.3'e düşürün, yaratıcı çalışmalar için 0.9'da kalın.
• Günlük sohbetler için no_think kullanın. Varsayılan akıl yürütme modu boşuna kapalı değildir; planlama, çok adımlı kod veya matematik için yalnızca low veya high'a ihtiyacınız vardır. Tek satırlık bir soruda high çalıştırmak, akıl yürütme jetonlarını boşa harcar.
• Sistem isteminde araçları adlandırın. Hy3, belirli bir ayrıştırıcı (hy_v3) ile araç kullanımı için eğitildi. OpenRouter'da bile, sistem istemi yalnızca şemaya güvenmek yerine her aracın görevini tanımladığında daha iyi çağrılar alırsınız.
• Kodu alıntılayın, özetlemeyin. 256K penceresi, tüm dosyaları yapıştırmanıza olanak tanır. Dosyayı yapıştırın, ardından soruyu sorun; modelden kodu hayal etmesini istemeyin.
• Çoklu dosya düzenlemelerini toplu yapın. Hy3'ün 74.4'lük SWE-bench Verified puanı, birkaç dosyayı tutarlı bir şekilde düzenlemekten gelir. Parça parça vermek yerine tüm seti tek bir mesajda verin.
• Önce bir plan isteyin. Ajansiyel görevler için, iki aşamalı bir desen ("bir plan taslağı hazırla, onayımı bekle, sonra yürüt") tek seferlik istemlerden daha tutarlı bir şekilde daha temiz sonuçlar üretir.

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

Bunları atlarsanız, birkaç tuzak sizi yanıltabilir.

• Hız limitleri yüke göre esner. OpenRouter'ın ücretsiz katmanı, tüm ücretsiz kullanıcılar arasında kapasiteyi paylaşır. Lansmanda, günlük istem hacmi zaten 6.81B jetondu; yoğun saatlerde yapılan çağrılarda 429 hataları görülebilir. Üstel geri çekilme (exponential backoff) ile yeniden denemeler oluşturun.
• Akıl yürütme jetonları çıktı olarak sayılır. reasoning_details OpenRouter ücretsiz katmanında ücretsizdir, ancak ücretli rotalarda çıktı olarak faturalandırılır. Gelire duyarlı bir ürüne ölçüm yapmadan effort: "high" varsayılanlarını göndermeyin.
• Lisans Apache 2.0 değildir. Tencent Hy Topluluk Lisansı ticari kullanıma izin verir ancak kullanım politikası ve atıf maddeleri içerir; Hy3'ü bir ürüne gömmeden önce GitHub deposundaki tam lisansı okuyun.
• Araç çağrısı doğru ayrıştırıcıyı gerektirir. Kendi kendine barındırıyorsanız, vLLM veya SGLang'i --tool-call-parser hy_v3 (veya SGLang için hunyuan) ile çalıştırın. Bu olmadan, araç çağrıları düz metin olarak geri döner.
• İngilizce ve Çince birinci sınıf; diğer diller ikinci sınıftır. C-Eval 89.80 ve CMMLU 89.61 puanları güçlü Çince'yi göstermektedir. Diğer diller MMMLU aracılığıyla desteklenir ancak kaliteleri düşer.
• Bazı akıl yürütme kıyaslamalarında önde gelen ABD amiral gemilerinin gerisinde kalıyor. HLE 30'da yer alıyor ve SCMP haberine göre Hy3, en iyi Çin modelleriyle aynı seviyede ancak en zorlu akıl yürütme paketlerinde OpenAI ve Google DeepMind'ın mevcut amiral gemilerinin hala gerisinde.

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

Komut satırı curl, bir demo için iyidir. Gerçek yineleme için görsel bir API istemcisi saatler kazandırır.

1. Apidog'u açın ve yeni bir proje oluşturun. OpenAI Sohbet Tamamlama OpenAPI spesifikasyonunu içe aktarın; OpenRouter aynı şemayı kullanır.
2. Temel URL'yi https://openrouter.ai/api/v1 olarak ayarlayın ve OPENROUTER_API_KEY için bir ortam değişkeni ekleyin.
3. Modeli tencent/hy3-preview:free olarak ayarlanmış şekilde /chat/completions adresine bir istek oluşturun.
4. Akıl yürütme modlarını karşılaştırmak için isteği çatallayın (fork). Apidog, bir isteği kopyalamanıza ve tek bir parametreyi ayarlamanıza olanak tanır, böylece aynı istemi no_think, low ve high ile yan yana çalıştırabilir ve gecikme ile çıktı farkını inceleyebilirsiniz.
5. İstem şablonlarını kaydedin. Ajansiyel istemler uzayabilir. Apidog'un ortam ve değişken sistemi, sistem istemlerini, araç şemalarını ve kullanıcı dönüşlerini ayrı tutar, böylece bunları testler arasında yeniden kullanabilirsiniz.

Postman'den geliyorsanız, geçiş hızlıdır; 2026'da Postman olmadan API testi kılavuzumuz geçişi kapsar. Editörlerinde yaşayan ekipler, çıktıyı tüketen kodun yanında istem ayarını tutan VS Code içinde Apidog ile aynı iş akışını VS Code içinde çalıştırabilir.

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

Yoğun saatlerde OpenRouter ücretsiz havuzu sizi kısıtlarsa, önce denemeye değer iki yol var.

• Hugging Face Space. Hy3-preview Alanı bir tarayıcı sohbet demosu barındırır. Betiklenebilir değildir, ancak ücretsizdir ve hızlı karşılaştırmalar için kullanışlıdır.
• Diğer ücretsiz Çin açık ağırlıklı modelleri. Alibaba'nın Qwen 3.5 Omni, güçlü çok modlu çıktıya sahip ücretsiz bir katman sunar; kurulum için Qwen 3.5 Omni duyurumuzu ve nasıl yapılır kılavuzumuzu inceleyin. Zhipu GLM 5V Turbo, cömert bir ücretsiz katmana sahip başka bir seçenektir; GLM 5V Turbo API kılavuzu tam bir inceleme sunar.

Bunlardan hiçbiri ajansiyel kodlama için Hy3'ün SWE-bench ve Terminal-Bench sayılarıyla eşleşmiyor, ancak ücretsiz Hy3 katmanının öncelik vermediği sohbet, çok dilli ve çok modlu kullanım senaryolarını kapsıyorlar. Bir üretim yapısı için Apidog'u indirin ve model başına bir koleksiyon kurun; gerçek istemleriniz üzerindeki yan yana kıyaslamalar, herhangi bir liderlik tablosunu okumaktan daha iyidir.

düğme

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

Donanımınız varsa, yerel çıkarım dördüncü ücretsiz yoldur. Model kartı, spekülatif kod çözme için tensör paralelliği 8 ve çoklu jeton tahmini etkinleştirilmiş vLLM'yi önerir:

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

Eşdeğer SGLang komutu --tool-call-parser hunyuan ve --reasoning-parser hunyuan kullanır. Sunucu http://localhost:8000/v1 adresinde çalıştığında, herhangi bir OpenAI SDK'sı OpenRouter'a işaret edeceği gibi ona işaret eder; yalnızca temel URL ve anahtar değişir.

Tam model için BF16'da sekiz adet H100 sınıfı GPU bekleyin. Kuantize edilmiş topluluk sürümleri ortaya çıkacaktır, ancak lansmanda resmi yol tam hassasiyettir.

Sıkça Sorulan Sorular

Hy3 Preview ücretsiz mi?Evet. OpenRouter, tencent/hy3-preview:free modelini milyon giriş jetonu başına 0$ ve milyon çıkış jetonu başına 0$ ile listeler. Ücretsiz katmandaki akıl yürütme jetonları da ücretsizdir, ancak hız limitlerine dahil edilirler. Üretim için ona güvenmeden önce güncel durumu OpenRouter model sayfasından teyit edin.

Hy3 Preview, DeepSeek V3 ve Qwen 3 ile nasıl karşılaştırılır?Hy3 Preview'ın 74.4'lük SWE-bench Verified puanı ve 54.4'lük Terminal-Bench 2.0'ı, onu en iyi Çin açık modelleriyle aynı seviyeye getirir; açık bir aracı ve araç kullanımı eğilimiyle. Saf sohbet için Qwen 3 ve DeepSeek V3 rekabetçidir; aracı ve kodlama iş akışları için Hy3'ün RL ile eğitilmiş araç kullanımı, ayırt edici özelliktir.

Hy3'ün akıl yürütme modları nelerdir?Üç tane: no_think (varsayılan, doğrudan yanıt), low ve high. Bunları OpenRouter'daki reasoning parametresi aracılığıyla veya modeli doğrudan çağırırken chat_template_kwargs={"reasoning_effort": "high"} ile değiştirin. Planlama, çok adımlı kod ve matematik için high kullanın; sohbet için kapalı bırakın.

Hy3 Preview'ı ticari olarak kullanabilir miyim?Evet, Tencent Hy Topluluk Lisansı kapsamında. Lisans, atıf ve kullanım politikası uyumluluğuyla ticari kullanıma izin verir. Gelir getiren bir üründe dağıtım yapmadan önce Hy3 GitHub deposundaki tam şartları okuyun.

Ücretsiz katman ne kadar bağlam uzunluğunu destekler?Uçtan uca 256K jeton. OpenRouter'ın listelemesi, model kartıyla eşleşen 262.144 jetonu gösterir. Orta büyüklükteki bir kod tabanının tamamını yapıştırabilir ve yine de araç şemaları ile konuşma geçmişi için yeriniz kalır.

Hy3 Preview'ı kod yazmadan nasıl test ederim?Bir tarayıcı sohbet demosu için Hugging Face Space'i kullanın veya Apidog'u OpenRouter uç noktasına yönlendirin. Apidog, OpenAI OpenAPI spesifikasyonunu içe aktarır, bu nedenle isteği yapılandırmak üç alandan oluşur: temel URL, API anahtarı ve model adı.