# Tổng quan (/vi/docs/api)

Base URL, xác thực, lỗi và mọi endpoint của API cheapaimodel.



API cheapaimodel hỗ trợ hai định dạng trên cùng một host: các endpoint tương thích OpenAI và endpoint Anthropic Messages. Cả hai dùng chung API key và số dư.

## Base URL [#base-url]

```text
https://api.cheapaimodel.ai
```

Client kiểu OpenAI dùng `https://api.cheapaimodel.ai/v1`; client kiểu Anthropic chỉ dùng host, không kèm đường dẫn. Xem [Base URL](/vi/docs/api/base-url) để biết giá trị mà từng SDK và công cụ cần.

## Xác thực [#authentication]

Gửi API key của bạn dưới dạng bearer token. `/v1/messages` cũng chấp nhận header `x-api-key` kiểu Anthropic.

```bash
curl https://api.cheapaimodel.ai/v1/models \
  -H "Authorization: Bearer $CHEAPAIMODEL_API_KEY"
```

Tạo key ở trang [API key](https://console.cheapaimodel.ai/keys) trong bảng điều khiển. Xem [Xác thực và API key](/vi/docs/concepts/authentication) để biết về hạn dùng, hạn mức chi tiêu và danh sách cho phép.

## Endpoint [#endpoints]

| Phương thức | Đường dẫn              |                                                                 |
| ----------- | ---------------------- | --------------------------------------------------------------- |
| `GET`       | `/v1/models`           | [List models](/vi/docs/api/list-models)                         |
| `POST`      | `/v1/chat/completions` | [Create a chat completion](/vi/docs/api/create-chat-completion) |
| `POST`      | `/v1/responses`        | [Create a response](/vi/docs/api/create-response)               |
| `POST`      | `/v1/messages`         | [Create a message](/vi/docs/api/create-message)                 |
| `POST`      | `/v1/embeddings`       | [Create embeddings](/vi/docs/api/create-embedding)              |

Đặt `"stream": true` trên các endpoint sinh nội dung để nhận server-sent events; xem [Streaming](/vi/docs/concepts/streaming).

## Lỗi [#errors]

Lỗi trả về mã trạng thái khác 2xx và body JSON có `error.message`. Xử lý theo mã trạng thái và `error.code`; xem bảng đầy đủ ở [Lỗi](/vi/docs/concepts/errors).

## OpenAPI [#openapi]

Bản đặc tả OpenAPI của các endpoint này nằm ở [`/docs/openapi.yaml`](/docs/openapi.yaml). Bạn có thể đưa tệp này cho công cụ sinh SDK hoặc trợ lý AI.