---
title: "BroadNet Inference hızlı başlangıç: Python ve cURL ile API"
description: "İlk sohbet ve transkripsiyon isteğinizi Python veya cURL ile BroadNet Inference'a gönderin, ardından seçtiğiniz model için geçiş kontrol listesini izleyin."
url: https://broadrouter.com/tr/developers/
lang: tr
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Geliştiriciler

Güncellendi 2026-11-15

BroadNet Inference, `https://inference.broadnet.ai/v1` adresinde OpenAI istek yapılarını kullanır. Konsolda bir anahtar oluşturup ortam değişkeninde saklayın, ardından modelin tam kimliğiyle `/chat/completions` veya `/audio/transcriptions` uç noktasına istek gönderin. Üretim trafiğini taşımadan önce o modelin parametrelerini, akışını, araçlarını, sınırlarını ve hatalarını kontrol edin.

-   Sohbet hızlı başlangıcı
-   Transkripsiyon hızlı başlangıcı
-   Model kimlikleri
-   Geçiş kontrol listesi
-   Hatalar ve yeniden denemeler
-   Belgeler ve rehberler

## İlk sohbet isteğimi nasıl gönderirim?

1.  [inference.broadnet.ai (İngilizce)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=quickstart-account) adresinde giriş yapıp bir çıkarım anahtarı oluşturun. Anahtar yalnızca bir kez gösterilir; konsol yalnızca hash değerini saklar.
2.  OpenAI SDK'yı kurun ve anahtarı kabuğunuzda (shell) tanımlayın. Anahtarları tarayıcı kodunda değil, her zaman sunucunuzda tutun.
3.  İsteği gönderin. Yanıtı `choices[0].message.content` alanından okuyun.

setup

```
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

first\_request.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

request.sh

```
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":"Reply with one short sentence."}]}'
```

Örnekte BroadNet Gemma 4 VL 26B kullanılıyor; US$5 tutarındaki başlangıç kredisi bu modeli kapsar. Önce bakiye yüklemesi gerekenler: DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B. Destek için `X-Request-ID` yanıt başlığını saklayın.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### Akış (streaming)

`stream=true` ayarlayın ve `data: [DONE]` gelene kadar Server-Sent Events okuyun. `stream_options.include_usage` ile token kullanımı son parçada gelir. Akış `[DONE]` gelmeden biterse yanıtı eksik kabul edin. BroadNet, üretimde akışa güvenmeden önce bunu her model için doğrulamanızı ister.

stream.sh

```
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 from one to three."}]}'
```

## Sesi nasıl yazıya dökerim?

Dosya başına en fazla 26.214.400 bayt WAV veya MP3 dosyasını `/audio/transcriptions` uç noktasına gönderin. `language` alanını her zaman ayarlayın: bu alan olmadan Arapça, Latin harfleriyle dönebilir. Arapça için `language=ar` kullanın. `.ogg` veya `.m4a` dosyalarını önce dönüştürün: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

Yanıt, transkripti `text` alanında içeren bir JSON'dur. [Arapça mı çok dilli model mi, ve sesin maliyeti](https://broadrouter.com/tr/arabic-transcription/).

## Hangi model kimliklerini kullanabilirim?

Tam kimliği `model` alanında gönderin. Sohbet modellerini bulmak için `/v1/models` uç noktasına güvenmeyin; bu listeyi veya [referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=models-docs#models) kullanın.

| Model | Kimlik | Uç nokta | Girdi | Belgelenen | Erişim |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/tr/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Metin + Görsel | Akıl yürütme | Bakiye yükleme gerekir |
| [GLM 5.3](https://broadrouter.com/tr/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Metin | Araçlar, Yapılandırılmış çıktı, Akıl yürütme | Bakiye yükleme gerekir |
| [Qwen3.8 27B](https://broadrouter.com/tr/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Metin + Görsel | Araçlar, Yapılandırılmış çıktı, Akıl yürütme | Bakiye yükleme gerekir |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/tr/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Metin + Görsel | — | Başlangıç kredisi |
| [BroadNet Transcribe Arabic](https://broadrouter.com/tr/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Arapça ses | — | Başlangıç kredisi |
| [BroadNet Transcribe](https://broadrouter.com/tr/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Ses, 14 dil | — | Başlangıç kredisi |

"Belgelenen" sütunu, BroadNet referansının her model için adını verdiği araçları, yapılandırılmış çıktıyı ve akıl yürütmeyi listeler (2026-11-15 tarihinde kontrol edildi). Tire, referansın bunları belirtmediği anlamına gelir; olmadıkları anlamına gelmez.

## Başka bir OpenAI uyumlu API'den geçiş: kontrol listesi

İstek yapıları tanıdıktır ama modeller farklıdır. Seçtiğiniz model için her maddeyi gözden geçirin ve trafiği taşımadan önce test edin.

1.  **Uç nokta.** Temel URL'yi `https://inference.broadnet.ai/v1` olarak ayarlayın.
2.  **Anahtar.** Bir ortam değişkenindeki BroadNet çıkarım anahtarını kullanın. Plan anahtarları ile kullandıkça öde anahtarları ayrıdır.
3.  **Model kimliği.** Tam kimliği kullanın, örneğin `broadnet/gemma-4-26b-a4b`.
4.  **Parametreler.** Gönderdiğiniz her parametrenin o model için belgelendiğini kontrol edin. Listede olmayanları kaldırın.
5.  **Akış.** İstemcinizin SSE akışını `[DONE]` gelene kadar okuduğunu ve erken biten bir akışı ele aldığını doğrulayın.
6.  **Araçlar ve yapılandırılmış çıktı.** Referans bunları şu modeller için belgeler: GLM 5.3 ve Qwen3.8 27B. Başka bir modelde bunlara güvenmeden önce test edin.
7.  **Akıl yürütme.** Akıl yürütme, çıktı bütçesinin bir kısmını kullanabilir. `max_tokens` değerinde pay bırakın; bkz. [akıl yürütme modellerinden gelen boş yanıtlar](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
8.  **Sınırlar.** Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. Plan oturumu aynı anda tek isteğe izin verir. Gemma saatlik anahtarı tek akışa, dakikada 120 isteğe ve dakikada 300.000 token'a izin verir.
9.  **Bağlam.** Bağlam, girdiyi ve yanıtı birlikte kapsar. Modelin sınırını [model sayfasında](https://broadrouter.com/tr/models/) kontrol edin.
10.  **Hatalar.** Aşağıdaki durum kodlarını yeniden deneme veya düzeltme eylemleriyle eşleyin ve `X-Request-ID` değerini günlüğe kaydedin.
11.  **Maliyetler.** Tahmin için [fiyat hesaplayıcılarını](https://broadrouter.com/tr/pricing/) kullanın. Kullandıkça öde modelinde görseller girdi token'ı olarak sayılır.

## Hangi hataları yeniden denemeliyim?

| Durum | Anlamı | Eylem |
| --- | --- | --- |
| 400 / 422 | Geçersiz istek veya alan | İsteği düzeltin; olduğu gibi yeniden denemeyin |
| 401 | Eksik, geçersiz veya süresi dolmuş anahtar ya da tükenmiş kullanım hakkı | Anahtarı ve hesabı kontrol edin |
| 402 | `insufficient_balance` | Bakiye yükleyip yeniden deneyin |
| 413 | İstek bayt veya metin sınırını aşıyor | Daha az veri gönderin, örneğin daha küçük bir ses dosyası |
| 429 | Hız, eşzamanlılık, token hızı veya harcama sınırı | Sınırlı sayıda deneme ile bekleyip yeniden deneyin |
| 500–504 | Sunucu tarafında sorun | Sınırlı üstel geri çekilme (exponential backoff) ile yeniden deneyin |

[Referanstaki hata tablosundan (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=errors-docs#errors) özetlenmiştir, 2026-11-15 tarihinde kontrol edildi. [Yeniden deneme kod örnekleri](https://broadrouter.com/tr/guides/errors-and-retries/).

## Belgelerin ve rehberlerin tamamı nerede?

-   [**Geliştirici referansı (İngilizce)**İstek yapıları, sınırlar, hatalar ve fiyat beslemesi. Yetkili kaynak.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=docs)
-   [**Entegrasyonlar (İngilizce)**Aider, Cline, LangChain, n8n, LiteLLM ve diğer OpenAI uyumlu araçlar için ayarlar.](https://broadrouter.com/integrations/)
-   [**Rehberler**SDK'lar, akış, yeniden denemeler, IP izin listeleri ve Arapça konuşma.](https://broadrouter.com/tr/guides/)
-   [**Python SDK rehberi**OpenAI Python SDK ile kurulum, ilk istek ve akış.](https://broadrouter.com/tr/guides/openai-python-sdk/)
-   [**Node SDK rehberi**Aynısı JavaScript ve TypeScript ile, istek kimlikleriyle birlikte.](https://broadrouter.com/tr/guides/openai-node-sdk/)
-   [**cURL hızlı başlangıç**Tüm istekler kabuktan (shell).](https://broadrouter.com/tr/guides/curl-quickstart/)
-   [**Anahtarlar ve IP izin listeleri**Anahtarlarınızı sunucularınızla sınırlayın.](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/)
-   [**API istek oluşturucu (İngilizce)**Tarayıcınızda bir istek oluşturup kopyalayın.](https://broadrouter.com/tools/api-request-builder/)

Özel bir uç noktaya veya listede olmayan bir modele mi ihtiyacınız var? [BroadNet'e ulaşın](https://broadrouter.com/tr/contact/#private).

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-developers&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference geliştirici referansı (2026-11-15 tarihinde kontrol edildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=sources)
-   [BroadNet Inference fiyatları (İngilizce)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=sources)
-   [pricing.json, yayımlanan fiyat listesi (İngilizce)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-developers&utm_content=sources)
