---
title: "Apakah itu Chat Completions API? Endpoint chat /v1 | BroadRouter"
description: "Chat Completions API menerima mesej bertanda peranan dan memulangkan jawapan model. Cara permintaan dan respons berfungsi, dan sebab ramai penyedia menirunya."
url: https://broadrouter.com/ms/glossary/chat-completions-api/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/glossary/chat-completions-api/) (dikemas kini 2026-11-16).

# Chat Completions API

Dikemas kini 2026-11-16

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

Juga dikenali sebagai: endpoint chat completions, API chat OpenAI, Chat Completions, chat completions endpoint, /v1/chat/completions, chat.completions.create

Kebanyakan kod LLM di luar sana bertutur dalam satu dialek: senarai mesej masuk, satu mesej keluar. Dialek itu ialah Chat Completions API.

## Cara ia berfungsi

Anda membuat POST JSON ke `/v1/chat/completions` dengan `model` dan tatasusunan `messages`. Setiap mesej mempunyai `role` (`system`, `user`, `assistant` atau `tool`) dan `content`. Jawapan mengandungi tatasusunan `choices`; setiap choice membawa `message` dan [finish\_reason](https://broadrouter.com/ms/glossary/finish-reason/) yang menyatakan sebab penjanaan tamat, serta blok `usage` dengan kiraan token.

```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":"system","content":"Answer in one line."},
                   {"role":"user","content":"What is a token?"}]}'
```

Dalam OpenAI Python SDK, panggilan yang sama ialah `client.chat.completions.create(...)`. Medan pilihan membentuk output: `max_tokens`, `temperature`, `stream`, `tools`, `response_format` dan lain-lain.

API ini tanpa keadaan. Panduan migrasi OpenAI menyatakan bahawa dalam Chat Completions, “conversation state must be managed manually” (Terjemahan BroadRouter: “keadaan perbualan mesti diurus secara manual”): kod anda menyimpan sejarah dan menghantarnya semula setiap giliran. Responses API OpenAI yang lebih baharu menggunakan item bertaip dan boleh membawa keadaan di sisi pelayan, dan OpenAI mengesyorkannya untuk projek baharu di platformnya sendiri, tetapi menyatakan Chat Completions “remains supported” (Terjemahan BroadRouter: “masih disokong”).

## Mengapa ia penting

-   **Kebolehalihan.** [API yang serasi OpenAI](https://broadrouter.com/ms/glossary/openai-compatible-api/) biasanya bermaksud endpoint ini. Menukar penyedia selalunya hanya memerlukan [base URL](https://broadrouter.com/ms/glossary/base-url/), kunci dan nama model yang baharu.
-   **Kos.** Oleh sebab keseluruhan sejarah dihantar semula, token input bertambah setiap giliran. Pangkas atau ringkaskan perbualan yang panjang.
-   **Perbezaan medan.** Bukan semua penyedia yang serasi menerima setiap medan OpenAI. Medan yang tidak dikenali mungkin diabaikan atau ditolak, jadi uji medan yang anda harapkan.

## Di BroadNet Inference

BroadNet menyediakan chat di POST /v1/chat/completions pada `https://inference.broadnet.ai/v1`, untuk DeepSeek V4.1 Flash, [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/) dan [Gemma 4 VL 26B](https://broadrouter.com/ms/models/gemma-4-vl-26b/). [Penstriman](https://broadrouter.com/ms/glossary/streaming/) menggunakan `stream=true` dan tamat dengan `data: [DONE]`. Tool calling dan output berstruktur didokumenkan untuk GLM 5.3 dan Qwen3.8 27B sahaja. [Rujukan API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-chat-completions-api&utm_content=body) BroadNet tidak mendokumenkan endpoint Responses, jadi gunakan Chat Completions. Mulakan dengan [panduan pantas curl](https://broadrouter.com/ms/guides/curl-quickstart/) atau [panduan Python SDK](https://broadrouter.com/ms/guides/openai-python-sdk/).

## Kesilapan biasa

-   Menghantar mesej pengguna terkini sahaja dan mengharapkan model mengingati perbualan.
-   Menyalin medan khusus OpenAI kepada penyedia lain tanpa menyemak rujukannya.

## Soalan lazim

### Adakah Chat Completions API sudah lapuk?

Tidak. Panduan migrasi OpenAI menyatakan "Chat Completions remains supported" (Chat Completions masih disokong), sambil mengesyorkan Responses API yang lebih baharu untuk projek baharu di OpenAI.

### Adakah Chat Completions API mengingati mesej terdahulu?

Tidak. Ia tanpa keadaan (stateless). Panduan OpenAI menyatakan keadaan perbualan "must be managed manually" (mesti diurus secara manual), jadi anda menghantar sejarah mesej penuh dengan setiap permintaan.

### Endpoint manakah yang digunakan BroadNet Inference untuk chat?

POST /v1/chat/completions pada base URL https://inference.broadnet.ai/v1. BroadNet tidak mendokumenkan endpoint Responses API.

## Lihat juga

-   [API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/) (istilah)
-   [Base URL (URL asas)](https://broadrouter.com/ms/glossary/base-url/) (istilah)
-   [Penstriman (streaming)](https://broadrouter.com/ms/glossary/streaming/) (istilah)
-   [finish\_reason](https://broadrouter.com/ms/glossary/finish-reason/) (istilah)
-   [Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/) (istilah)
-   [Prompt sistem (system prompt)](https://broadrouter.com/ms/glossary/system-prompt/) (istilah)
-   [Token imej (image tokens)](https://broadrouter.com/ms/glossary/image-tokens/) (istilah)
-   [Permintaan pertama ke BroadNet Inference dengan curl](https://broadrouter.com/ms/guides/curl-quickstart/) (panduan)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/) (panduan)
-   [Strim chat completions dan kendalikan sambungan yang terputus](https://broadrouter.com/ms/guides/streaming-chat-completions/) (panduan)
-   [Berpindah dari API OpenAI: panduan kod dalam Python, Node, cURL](https://broadrouter.com/ms/blog/migrate-from-openai-api-code-walkthrough/) (artikel)
-   [Beralih ke API serasi OpenAI: senarai semak migrasi](https://broadrouter.com/ms/blog/openai-compatible-api-migration-checklist/) (artikel)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-chat-completions-api&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API OpenAI, create chat completion (disemak 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, migrate to the Responses API (disemak 2026-11-15)](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [Rujukan API BroadNet Inference (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-chat-completions-api&utm_content=sources)
