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 und jedes entsprechende Tool.
1. Schlüssel setzen
Erstellen Sie in der Konsole von BroadNet einen Schlüssel. Neue Konten erhalten $5 Startguthaben.
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:
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:
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.
4. Die Antwort streamen
Ergänzen Sie "stream": true und schalten Sie die Pufferung von curl mit -N ab:
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.
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:
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. Für Arabisch verwenden Sie broadnet/cohere-transcribe-arabic mit language=ar; siehe die Anleitung zu Speech-to-Text für Arabisch. 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. Jedes Modell hat eine eigene Seite, zum Beispiel 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.
- 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.
- Mit einem unbegrenzten Plan. Jede Plan-Session 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.
