---
title: "LLM API curl quickstart: chat, streaming, transcription"
description: "Ipadala ang una mong BroadNet Inference call gamit ang curl: chat completion, streamed na sagot at audio transcription, at basahin ang response, usage at errors."
url: https://broadrouter.com/fil/guides/curl-quickstart/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/curl-quickstart/) (na-update noong 2026-11-16).

# Paano gamitin ang curl sa BroadNet Inference: ang una mong request

Na-update 2026-11-16

Magpadala ng POST sa https://inference.broadnet.ai/v1/chat/completions na may header na Authorization Bearer at ang key mo, at JSON body na may model, halimbawa broadnet/gemma-4-26b-a4b, at messages. Idagdag ang stream true para sa streaming. Para sa audio, mag-post ng multipart form na may model, language at file sa /v1/audio/transcriptions.

Dadalhin ka ng page na ito mula sa bagong key hanggang sa tatlong gumaganang call: isang chat completion, isang streamed na sagot at isang transcription. curl lang ang kailangan mo. Ginagamit ng BroadNet Inference ang request format ng OpenAI, kaya kapag gumana na ang mga ito, gagana na rin ang kahit anong [OpenAI-compatible SDK](https://broadrouter.com/fil/guides/openai-python-sdk/) o tool.

## 1\. I-set ang key mo

Gumawa ng key sa console ng BroadNet. May $5 na panimulang credit ang mga bagong account.

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

Ipadala lang ang key sa `Authorization: Bearer` header.

## 2\. Ang una mong chat completion

Ang BroadNet Gemma 4 VL 26B ang nag-iisang chat model na tumatakbo sa panimulang credit, kaya doon magsimula:

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

Standard na chat-completions JSON ang sagot. Nasa `choices[0].message.content` ang sagot ng model, at nasa `usage` ang bilang ng token na binabayaran mo.

## 3\. Subukan ang isang reasoning model

Pagkatapos mag-top up, palitan ang model. Nagre-reason muna ang GLM 5.3, Qwen3.8 27B at DeepSeek V4.1 Flash bago sumagot, at kasama ang reasoning na iyon sa `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."}]
  }'
```

Kung walang laman ang `content` at `length` ang `finish_reason`, naubos ang budget habang nagre-reason pa ang model. Tingnan kung [bakit walang laman ang sagot ng mga reasoning model](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).

## 4\. I-stream ang sagot

Idagdag ang `"stream": true` at i-off ang buffering ng curl gamit ang `-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."}]}'
```

Server-Sent Events ang matatanggap mo. Nagtatapos ang stream sa mismong linyang `data: [DONE]`, at kapag may `include_usage`, nasa huling chunk ang bilang ng token. Higit pa rito sa [streaming chat completions](https://broadrouter.com/fil/guides/streaming-chat-completions/).

## 5\. Mag-transcribe ng audio

Multipart form ang tinatanggap ng transcription. Magpadala ng WAV o MP3, hanggang 26,214,400 bytes, at laging ipadala ang `language`:

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

JSON ang response, at nasa `text` ang transcript. Kailangan munang i-convert ang mga `.ogg` voice note mula sa WhatsApp at ang mga `.m4a` recording; tingnan ang [paano mag-transcribe ng WhatsApp voice notes](https://broadrouter.com/fil/guides/transcribe-whatsapp-voice-notes/). Para sa Arabic, gamitin ang `broadnet/cohere-transcribe-arabic` na may `language=ar`; tingnan ang [gabay sa Arabic speech-to-text](https://broadrouter.com/fil/guides/arabic-speech-to-text-api/). $0.002 kada minuto ng audio ang multilingual na model, at $0.0042 naman ang Arabic na model.

## Aling model ang pipiliin

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

Nasa [pricing page](https://broadrouter.com/fil/pricing/) ang presyo kada token at kada minuto. May sariling page ang bawat model, halimbawa ang [GLM 5.3](https://broadrouter.com/fil/models/glm-5.3/).

## Troubleshooting

-   **401.** Wala, invalid o expired ang key, o naubos na ang pay-as-you-go allowance. Tingnan kung may sobrang space sa paligid ng key.
-   **Error sa model field.** Kopyahin ang ID mula sa table; kasama rito ang `broadnet/` prefix. Pumapalya ang mga bayad na model sa panimulang credit hangga’t hindi ka nagta-top up.
-   **413.** Lampas sa 26,214,400 bytes ang audio file. Hatiin ito.
-   **403.** Tinanggihan ang request ng IP allow-list, model policy o route policy ng key. Tingnan ang [IP allow-lists para sa API keys](https://broadrouter.com/fil/guides/api-keys-ip-allow-lists/).
-   **429.** Ang isang pay-as-you-go key ay may 30 request kada minuto at 4 na sabay-sabay na request. Maghintay muna bago mag-retry. Tingnan ang [error codes at retries ng BroadNet](https://broadrouter.com/fil/guides/errors-and-retries/).
-   **Kung naka-unlimited plan ka.** Isang request sa bawat pagkakataon ang tinatakbo ng bawat [plan session](https://broadrouter.com/fil/guides/unlimited-llm-api-sessions/), kaya patakbuhin ang mga parallel na curl loop sa magkakahiwalay na session. Gumagana lang ang mga plan key sa `broadnet/deepseek-v4.1-flash`.

I-save ang response header na `X-Request-ID` (`curl -D headers.txt ...`) kapag nag-uulat ka ng problema.

## Mga termino sa gabay na ito

[API key](https://broadrouter.com/fil/glossary/api-key/)

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

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

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

[Speech-to-text (STT)](https://broadrouter.com/fil/glossary/speech-to-text/)

Ang speech-to-text, na tinatawag ding automatic speech recognition (ASR), ay teknolohiyang ginagawang nakasulat na text ang binigkas na audio. Tumatanggap ang speech-to-text API ng audio file o stream at nagbabalik ng transcript, kadalasang may presyo kada minuto ng audio. Sinusukat ang accuracy gamit ang word error rate, at nag-iiba ito ayon sa accent, dialect at kalidad ng recording.

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

Ang token ay ang yunit ng text na binabasa at isinusulat ng isang language model: isang salita, bahagi ng salita, bantas o byte sequence na ginawa ng tokenizer ng model. Sa token binibilang, nililimitahan at kadalasang sinisingil ng mga LLM API ang paggamit.

[Concurrency](https://broadrouter.com/fil/glossary/concurrency/)

Ang concurrency ay ang bilang ng request na sabay-sabay na in flight mula sa isang client. Madalas itong nililimitahan ng mga LLM API kada key o plan, hiwalay sa requests per minute, dahil humahawak ng GPU capacity ang bawat bukas na request hanggang matapos ang response nito.

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

Ang Chat Completions API ay HTTP endpoint ng OpenAI, POST /v1/chat/completions, na tumatanggap ng pangalan ng model at listahan ng mga message na may role, at ibinabalik ang susunod na message ng model. Ang hugis ng request at response nito ang naging karaniwang format na ginagamit din ng mga OpenAI-compatible na provider at SDK.

[Rate limit](https://broadrouter.com/fil/glossary/rate-limit/)

Ang rate limit ay hangganang itinatakda ng API sa dami ng paggamit ng isang client sa isang yugto ng oras, gaya ng request kada minuto o token kada minuto. Tinatanggihan ang mga request na lampas sa limit, kadalasan na may HTTP 429 Too Many Requests, hanggang bumaba ulit ang paggamit.

[Server-sent events (SSE)](https://broadrouter.com/fil/glossary/sse/)

Ang server-sent events (SSE) ay web standard kung saan nagpapadala ang server ng tuloy-tuloy na text event sa client sa iisang matagal na HTTP response na may content type na text/event-stream. Ang bawat event ay isa o higit pang field line, gaya ng data:, na tinatapos ng blank line.

## Mga tanong

### Aling model ang puwede kong tawagin gamit ang libreng panimulang credit?

Ang BroadNet Gemma 4 VL 26B, na may model ID na broadnet/gemma-4-26b-a4b, at ang dalawang transcription model. Kailangan ng top-up para sa GLM 5.3, Qwen3.8 27B at DeepSeek V4.1 Flash.

### Bakit walang laman ang message content sa curl response ko?

Ginagamit muna ng mga reasoning model ang max\_tokens sa reasoning. Kung length ang finish\_reason, taasan ang max\_tokens sa 1,000 o higit pa.

### Bakit nasa letrang Latin ang Arabic transcript ko?

Walang language field ang request. Ipadala ang language=ar para sa Arabic, at ang katugmang ISO 639-1 code para sa ibang wika.

### Nakalista ba sa GET /v1/models ang lahat ng model na puwede kong tawagin?

Ayon sa docs ng BroadNet, ang GET /v1/models ay "supplies public catalogue metadata for external monitors" (salin: nagbibigay ng public catalog metadata para sa mga external monitor). Para sa mga request, gamitin ang mga model ID mula sa API reference o sa pricing.json.

## Mga kaugnay na gabay

-   [Paano gamitin ang OpenAI Python SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-python-sdk/)
-   [Paano mag-stream ng chat completions at ayusin ang naputol na stream](https://broadrouter.com/fil/guides/streaming-chat-completions/)
-   [Arabic speech-to-text API: gabay na hakbang-hakbang](https://broadrouter.com/fil/guides/arabic-speech-to-text-api/)
-   [Mga error code ng BroadNet Inference at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/)

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

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

**Mga source**

-   [API reference ng BroadNet Inference (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-curl-quickstart&utm_content=sources)
-   [Machine-readable na listahan ng model at presyo (pricing.json) (Ingles)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-curl-quickstart&utm_content=sources)
