---
title: "LLM-API mit curl: Chat, Streaming, Transkription | BroadRouter"
description: "Erste Aufrufe an BroadNet Inference mit curl: Chat Completion, gestreamte Antwort und Audio-Transkription, dazu Antwort, Token-Nutzung und Fehler lesen."
url: https://broadrouter.com/de/guides/curl-quickstart/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/curl-quickstart/) (aktualisiert am 2026-11-16).

# Schnellstart mit curl: erste Anfrage an BroadNet Inference

Aktualisiert 2026-11-16

Senden Sie einen POST an https://inference.broadnet.ai/v1/chat/completions mit dem Header Authorization Bearer und Ihrem Schlüssel sowie einem JSON-Body mit model, etwa broadnet/gemma-4-26b-a4b, und messages. Für Streaming ergänzen Sie stream true. Für Audio senden Sie ein Multipart-Formular mit model, language und file an /v1/audio/transcriptions.

Diese Seite bringt Sie von einem neuen Schlüssel zu drei funktionierenden Aufrufen: einer Chat Completion, einer gestreamten Antwort und einer Transkription. Sie brauchen nur curl. BroadNet Inference verwendet das Anfrageformat von OpenAI. Sobald diese Aufrufe laufen, funktioniert daher auch jedes [OpenAI-kompatible SDK](https://broadrouter.com/de/guides/openai-python-sdk/) und jedes entsprechende Tool.

## 1\. Schlüssel setzen

Erstellen Sie in der Konsole von BroadNet einen Schlüssel. Neue Konten erhalten $5 Startguthaben.

```bash
export BROADNET_API_KEY='paste-your-key'
```

Senden Sie den Schlüssel ausschließlich im Header `Authorization: Bearer`.

## 2\. Ihre erste Chat Completion

BroadNet Gemma 4 VL 26B ist das einzige Chatmodell, das mit dem Startguthaben läuft. Beginnen Sie also damit:

```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."}]
  }'
```

Die Antwort ist gewöhnliches Chat-Completions-JSON. Der Antworttext steht in `choices[0].message.content`, und `usage` enthält die Token-Zahlen, die Ihnen berechnet werden.

## 3\. Ein Reasoning-Modell ausprobieren

Nach einer Aufladung wechseln Sie das Modell. GLM 5.3, Qwen3.8 27B und DeepSeek V4.1 Flash denken nach (Reasoning), bevor sie antworten, und dieses Reasoning zählt zu `max_tokens`:

```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."}]
  }'
```

Ist `content` leer und steht `finish_reason` auf `length`, war das Budget schon während des Reasonings aufgebraucht. Siehe [warum Reasoning-Modelle leere Antworten liefern](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).

## 4\. Die Antwort streamen

Ergänzen Sie `"stream": true` und schalten Sie die Pufferung von curl mit `-N` ab:

```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."}]}'
```

Sie erhalten Server-Sent Events. Der Stream endet mit der wörtlichen Zeile `data: [DONE]`, und mit `include_usage` trägt der letzte Chunk die Token-Zahlen. Mehr dazu unter [Chat Completions streamen](https://broadrouter.com/de/guides/streaming-chat-completions/).

## 5\. Audio transkribieren

Die Transkription erwartet ein Multipart-Formular. Senden Sie WAV oder MP3 mit bis zu 26.214.400 Bytes, und senden Sie immer `language` mit:

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

Die Antwort ist JSON, das Transkript steht in `text`. WhatsApp-Sprachnachrichten im Format `.ogg` und Aufnahmen im Format `.m4a` müssen Sie vorher konvertieren; siehe [WhatsApp-Sprachnachrichten transkribieren](https://broadrouter.com/de/guides/transcribe-whatsapp-voice-notes/). Für Arabisch verwenden Sie `broadnet/cohere-transcribe-arabic` mit `language=ar`; siehe die [Anleitung zu Speech-to-Text für Arabisch](https://broadrouter.com/de/guides/arabic-speech-to-text-api/). Das mehrsprachige Modell kostet $0.002 pro Audiominute, das arabische Modell $0.0042.

## Welches Modell passt?

| Modell | ID | Endpoint | Startguthaben |
| --- | --- | --- | --- |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | `/v1/chat/completions` | Ja |
| GLM 5.3 | `broadnet/glm-5.3` | `/v1/chat/completions` | Nein |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | `/v1/chat/completions` | Nein |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | `/v1/chat/completions` | Nein |
| BroadNet Transcribe | `broadnet/cohere-transcribe` | `/v1/audio/transcriptions` | Ja |
| BroadNet Transcribe Arabic | `broadnet/cohere-transcribe-arabic` | `/v1/audio/transcriptions` | Ja |

Die Preise pro Token und pro Minute stehen auf der [Preisseite](https://broadrouter.com/de/pricing/). Jedes Modell hat eine eigene Seite, zum Beispiel [GLM 5.3](https://broadrouter.com/de/models/glm-5.3/).

## Fehlerbehebung

-   **401.** Der Schlüssel fehlt, ist ungültig oder abgelaufen, oder das Pay-as-you-go-Kontingent ist aufgebraucht. Prüfen Sie, ob vor oder nach dem Schlüssel Leerzeichen stehen.
-   **Fehler beim Feld model.** Kopieren Sie die ID aus der Tabelle; sie enthält das Präfix `broadnet/`. Kostenpflichtige Modelle schlagen mit dem Startguthaben fehl, bis Sie aufladen.
-   **413.** Die Audiodatei ist größer als 26.214.400 Bytes. Teilen Sie sie auf.
-   **403.** Die IP-Allowlist, die Modell- oder die Routenrichtlinie des Schlüssels hat die Anfrage abgelehnt. Siehe [IP-Allowlists für API-Schlüssel](https://broadrouter.com/de/guides/api-keys-ip-allow-lists/).
-   **429.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig laufende. Warten Sie mit Backoff und versuchen Sie es erneut. Siehe [Fehlercodes und Retries bei BroadNet](https://broadrouter.com/de/guides/errors-and-retries/).
-   **Mit einem unbegrenzten Plan.** Jede [Plan-Session](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) verarbeitet eine Anfrage gleichzeitig. Parallele curl-Schleifen brauchen deshalb jeweils eine eigene Session. Plan-Schlüssel funktionieren nur mit `broadnet/deepseek-v4.1-flash`.

Speichern Sie den Response-Header `X-Request-ID` (`curl -D headers.txt ...`), wenn Sie ein Problem melden.

## Begriffe in dieser Anleitung

[Speech-to-Text (Spracherkennung)](https://broadrouter.com/de/glossary/speech-to-text/)

Speech-to-Text, auch automatische Spracherkennung (ASR), ist eine Technik, die gesprochenes Audio in geschriebenen Text umwandelt. Eine Speech-to-Text API nimmt eine Audiodatei oder einen Stream entgegen und liefert ein Transkript, meist abgerechnet pro Audiominute. Die Genauigkeit wird mit der Wortfehlerrate gemessen und hängt von Akzent, Dialekt und Aufnahmequalität ab.

[IP-Allowlist (IP allow list)](https://broadrouter.com/de/glossary/ip-allow-list/)

Eine IP-Allowlist ist eine Sicherheitskontrolle, die nur Anfragen von gelisteten IP-Adressen oder CIDR-Bereichen annimmt und alle anderen ablehnt. Bei einer API begrenzt sie den Schaden eines geleakten Schlüssels, weil der Schlüssel aus nicht gelisteten Netzen nicht funktioniert.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[Server-Sent Events (SSE)](https://broadrouter.com/de/glossary/sse/)

Server-Sent Events (SSE) sind ein Webstandard, mit dem ein Server einem Client über eine einzige, lang offene HTTP-Antwort mit dem Content-Type text/event-stream einen Strom von Text-Events schickt. Jedes Event besteht aus einer oder mehreren Feldzeilen, etwa data:, und endet mit einer Leerzeile.

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

Die Chat Completions API ist der HTTP-Endpoint von OpenAI, POST /v1/chat/completions, der einen Modellnamen und eine Liste von Nachrichten mit Rollen entgegennimmt und die nächste Nachricht des Modells zurückgibt. Ihr Format für Anfrage und Antwort wurde zum gemeinsamen Standard, den OpenAI-kompatible Anbieter und SDKs übernehmen.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

[Prepaid-Guthaben (Prepaid Credit)](https://broadrouter.com/de/glossary/prepaid-credit/)

Prepaid-Guthaben ist Geld, das vor der Nutzung auf ein API-Konto eingezahlt wird. Jede Anfrage zieht ihre Kosten vom Guthaben ab, und wenn es aufgebraucht ist, stoppen abgerechnete Anfragen, bis Sie aufladen. So sind die Ausgaben auf das eingezahlte Geld begrenzt.

## Häufige Fragen

### Welches Modell kann ich mit dem kostenlosen Startguthaben aufrufen?

BroadNet Gemma 4 VL 26B mit der Modell-ID broadnet/gemma-4-26b-a4b sowie beide Transkriptionsmodelle. GLM 5.3, Qwen3.8 27B und DeepSeek V4.1 Flash erfordern eine Aufladung.

### Warum ist content in meiner curl-Antwort leer?

Reasoning-Modelle verbrauchen max\_tokens zuerst für das Reasoning. Steht finish\_reason auf length, erhöhen Sie max\_tokens auf 1.000 oder mehr.

### Warum kommt mein arabisches Transkript in lateinischen Buchstaben zurück?

Der Anfrage fehlte das Feld language. Senden Sie language=ar für Arabisch und für andere Sprachen den passenden ISO-639-1-Code.

### Listet GET /v1/models alle Modelle, die ich aufrufen kann?

Die Dokumentation von BroadNet sagt, GET /v1/models „supplies public catalogue metadata for external monitors“ (Übersetzung: „liefert öffentliche Katalog-Metadaten für externe Monitoring-Dienste“). Verwenden Sie für Anfragen die Modell-IDs aus der API-Referenz oder aus pricing.json.

## Verwandte Anleitungen

-   [OpenAI Python SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/openai-python-sdk/)
-   [Chat Completions streamen und abgebrochene Verbindungen behandeln](https://broadrouter.com/de/guides/streaming-chat-completions/)
-   [Speech-to-Text API für Arabisch: Schritt für Schritt](https://broadrouter.com/de/guides/arabic-speech-to-text-api/)
-   [Fehlercodes von BroadNet Inference: Wann ist ein Retry sinnvoll?](https://broadrouter.com/de/guides/errors-and-retries/)

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

[Loslegen](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-curl-quickstart&utm_content=page-cta) ·

**Quellen**

-   [API-Referenz von BroadNet Inference (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-curl-quickstart&utm_content=sources)
-   [Maschinenlesbare Modellliste und Preise (pricing.json) (auf Englisch)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-curl-quickstart&utm_content=sources)
