BroadRouter
Başlayın

curl ile BroadNet Inference'a ilk istek

Güncellendi

https://inference.broadnet.ai/v1/chat/completions adresine, anahtarınızı Authorization Bearer başlığında taşıyan bir POST isteği gönderin; JSON gövdesinde model (örneğin broadnet/gemma-4-26b-a4b) ve messages bulunsun. Akış için stream true ekleyin. Ses için model, language ve file alanlarını içeren multipart formu /v1/audio/transcriptions adresine gönderin.

Bu sayfa sizi yeni bir anahtardan çalışan üç isteğe götürür: bir sohbet yanıtı, akışla gelen bir yanıt ve bir transkripsiyon. Tek ihtiyacınız curl. BroadNet Inference OpenAI istek yapısını kullandığı için bunlar çalıştığında her OpenAI uyumlu SDK ve araç da çalışır.

1. Anahtarınızı ayarlayın

BroadNet konsolunda bir anahtar oluşturun. Yeni hesaplar $5 başlangıç kredisi alır.

export BROADNET_API_KEY='paste-your-key'

Anahtarı yalnızca Authorization: Bearer başlığında gönderin.

2. İlk sohbet isteğiniz

BroadNet Gemma 4 VL 26B, başlangıç kredisiyle çalışan tek sohbet modelidir; bu yüzden işe onunla başlayın:

curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/gemma-4-26b-a4b",
    "messages": [{"role": "user", "content": "Say hello in English and Arabic."}]
  }'

Yanıt standart chat completions JSON’udur. Cevap choices[0].message.content alanındadır; usage ise ödeme yaptığınız token sayılarını tutar.

3. Bir akıl yürütme modelini deneyin

Bakiye yükledikten sonra modeli değiştirin. GLM 5.3, Qwen3.8 27B ve DeepSeek V4.1 Flash yanıt vermeden önce akıl yürütür ve bu akıl yürütme max_tokens sınırına dahildir:

curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'

content boşsa ve finish_reason değeri length ise bütçe akıl yürütme sırasında tükenmiş demektir. Bkz. akıl yürütme modelleri neden boş yanıt döndürür.

4. Yanıtı akışla alın

"stream": true ekleyin ve -N ile curl’ün arabelleğe almasını kapatın:

curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count to five."}]}'

Yanıt Server-Sent Events olarak gelir. Akış birebir data: [DONE] satırıyla biter; include_usage ile son parça token sayılarını taşır. Ayrıntılar chat completions akışı rehberinde.

5. Ses kaydını yazıya dökün

Transkripsiyon multipart form ile çalışır. 26.214.400 bayta kadar WAV veya MP3 gönderin ve language alanını her zaman ekleyin:

curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3

Yanıt, transkripti text alanında içeren bir JSON’dur. WhatsApp .ogg sesli notları ve .m4a kayıtları önce dönüştürülmelidir; bkz. WhatsApp sesli notları nasıl yazıya dökülür. Arapça için language=ar ile broadnet/cohere-transcribe-arabic modelini kullanın; bkz. Arapça konuşmadan metne rehberi. Çok dilli model ses dakikası başına $0.002, Arapça model ise $0.0042 tutarındadır.

Hangi modeli seçmeli

Model Kimlik Uç nokta Ücretsiz kredi
BroadNet Gemma 4 VL 26B broadnet/gemma-4-26b-a4b /v1/chat/completions Evet
GLM 5.3 broadnet/glm-5.3 /v1/chat/completions Hayır
Qwen3.8 27B broadnet/qwen3.8-27b /v1/chat/completions Hayır
DeepSeek V4.1 Flash broadnet/deepseek-v4.1-flash /v1/chat/completions Hayır
BroadNet Transcribe broadnet/cohere-transcribe /v1/audio/transcriptions Evet
BroadNet Transcribe Arabic broadnet/cohere-transcribe-arabic /v1/audio/transcriptions Evet

Token ve dakika başına fiyatlar fiyatlar sayfasında. Her modelin kendi sayfası vardır, örneğin GLM 5.3.

Sorun giderme

  • 401. Anahtar eksik, geçersiz veya süresi dolmuş ya da kullandıkça öde kullanım hakkı tükenmiş. Anahtarın başında veya sonunda fazladan boşluk olup olmadığını kontrol edin.
  • model alanında hata. Kimliği tablodan kopyalayın; broadnet/ önekini içerir. Ücretli modeller, bakiye yükleyene kadar başlangıç kredisiyle çalışmaz.
  • 413. Ses dosyası 26.214.400 baytı aşıyor. Dosyayı bölün.
  • 403. İsteği anahtarın IP izin listesi, model veya rota politikası reddetti. Bkz. API anahtarları için IP izin listeleri.
  • 429. Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. Bekleyip yeniden deneyin. Bkz. BroadNet hata kodları ve yeniden denemeler.
  • Sınırsız plandaysanız. Her plan oturumu aynı anda tek istek çalıştırır; paralel curl döngülerini ayrı oturumlarda çalıştırın. Plan anahtarları yalnızca broadnet/deepseek-v4.1-flash ile çalışır.

Bir sorun bildirirken X-Request-ID yanıt başlığını saklayın (curl -D headers.txt ...).

Sık sorulan sorular

Ücretsiz başlangıç kredisiyle hangi modeli çağırabilirim?

BroadNet Gemma 4 VL 26B (model kimliği broadnet/gemma-4-26b-a4b) ve iki transkripsiyon modeli. GLM 5.3, Qwen3.8 27B ve DeepSeek V4.1 Flash için bakiye yüklemeniz gerekir.

curl yanıtımdaki mesaj içeriği neden boş?

Akıl yürütme modelleri max_tokens bütçesini önce akıl yürütmeye harcar. finish_reason değeri length ise max_tokens değerini 1.000 veya daha yukarı çıkarın.

Arapça transkriptim neden Latin harfleriyle geliyor?

İstekte language alanı yoktu. Arapça için language=ar, diğer diller için ilgili ISO 639-1 kodunu gönderin.

GET /v1/models çağırabileceğim her modeli listeler mi?

BroadNet'in belgelerine göre GET /v1/models "supplies public catalogue metadata for external monitors" (çeviri: dış izleme araçları için herkese açık katalog meta verisi sağlar). İsteklerde API referansındaki veya pricing.json içindeki model kimliklerini kullanın.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor