---
title: "curl ile LLM API hızlı başlangıç: sohbet, akış, ses | BroadRouter"
description: "curl ile ilk BroadNet Inference isteklerinizi gönderin: sohbet yanıtı, akışla gelen yanıt ve ses transkripsiyonu. Yanıtı, kullanımı ve hataları okuyun."
url: https://broadrouter.com/tr/guides/curl-quickstart/
lang: tr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/guides/curl-quickstart/) (güncelleme: 2026-11-16).

# curl ile BroadNet Inference'a ilk istek

Güncellendi 2026-11-16

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](https://broadrouter.com/tr/guides/openai-python-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.

```bash
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:

```bash
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:

```bash
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](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).

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

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

```bash
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ışı](https://broadrouter.com/tr/guides/streaming-chat-completions/) 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:

```bash
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](https://broadrouter.com/tr/guides/transcribe-whatsapp-voice-notes/). Arapça için `language=ar` ile `broadnet/cohere-transcribe-arabic` modelini kullanın; bkz. [Arapça konuşmadan metne rehberi](https://broadrouter.com/tr/guides/arabic-speech-to-text-api/). Ç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](https://broadrouter.com/tr/pricing/). Her modelin kendi sayfası vardır, örneğin [GLM 5.3](https://broadrouter.com/tr/models/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](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/).
-   **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](https://broadrouter.com/tr/guides/errors-and-retries/).
-   **Sınırsız plandaysanız.** Her [plan oturumu](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) 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 ...`).

## Bu rehberdeki terimler

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Token](https://broadrouter.com/tr/glossary/token/)

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Chat Completions API](https://broadrouter.com/tr/glossary/chat-completions-api/)

Chat Completions API, OpenAI'nin bir model adı ile rollerle etiketlenmiş mesaj listesini alıp modelin sonraki mesajını döndüren HTTP uç noktasıdır: POST /v1/chat/completions. İstek ve yanıt yapısı, OpenAI uyumlu sağlayıcıların ve SDK'ların yeniden kullandığı ortak format hâline geldi.

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

[Akış (streaming)](https://broadrouter.com/tr/glossary/streaming/)

Akış (streaming), bir dil modeli yanıtını sonda tek parça halinde değil, hâlâ üretilirken küçük parçalar halinde döndürme yöntemidir. OpenAI uyumlu API'ler, istekte stream değeri true olduğunda server-sent events (SSE) üzerinden akış yapar.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[IP izin listesi (IP allow list)](https://broadrouter.com/tr/glossary/ip-allow-list/)

IP izin listesi, yalnızca listelenen IP adreslerinden veya CIDR aralıklarından gelen istekleri kabul edip diğer tümünü reddeden bir güvenlik denetimidir. Bir API'de sızdırılmış bir anahtarın vereceği zararı sınırlar, çünkü anahtar listede olmayan ağlardan çalışmaz.

[Konuşmadan metne (speech-to-text)](https://broadrouter.com/tr/glossary/speech-to-text/)

Konuşmadan metne (speech-to-text), otomatik konuşma tanıma (ASR) olarak da bilinir; konuşulan sesi yazılı metne dönüştüren teknolojidir. Bir konuşmadan metne API'si ses dosyası veya akışı alıp transkript döndürür ve genellikle ses dakikası başına fiyatlandırılır. Doğruluk kelime hata oranıyla ölçülür; aksana, lehçeye ve kayıt kalitesine göre değişir.

## 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.

## İlgili rehberler

-   [OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [Chat completions akışı ve kopan bağlantıları ele alma](https://broadrouter.com/tr/guides/streaming-chat-completions/)
-   [Adım adım Arapça ses metne çevirme API'si](https://broadrouter.com/tr/guides/arabic-speech-to-text-api/)
-   [BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-curl-quickstart&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-curl-quickstart&utm_content=sources)
-   [Makine tarafından okunabilir model listesi ve fiyatlar (pricing.json) (İngilizce)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-curl-quickstart&utm_content=sources)
