BroadRouter
Loslegen

Schnellstart mit curl: erste Anfrage an BroadNet Inference

Aktualisiert

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

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.

Als Markdown lesenChatGPT fragenClaude fragenPerplexity fragen