# Base URL (/vi/docs/api/base-url)

Mọi endpoint của cheapaimodel dùng chung một host. Đây là Base URL chính xác cho từng SDK và công cụ.



Mọi endpoint đều nằm trên một host:

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

Không có host theo khu vực và không có host riêng cho từng nhà cung cấp. Cùng một API key và cùng một số dư dùng được cho cả hai định dạng bên dưới.

## Dùng giá trị nào [#which-value-to-use]

Client kiểu OpenAI cần Base URL có sẵn `/v1`; client kiểu Anthropic chỉ cần host (không kèm `/v1`) và tự thêm `/v1/messages`.

| Định dạng          | Base URL                         | Yêu cầu được gửi tới                                                    |
| ------------------ | -------------------------------- | ----------------------------------------------------------------------- |
| Tương thích OpenAI | `https://api.cheapaimodel.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings`, `/v1/models` |
| Anthropic Messages | `https://api.cheapaimodel.ai`    | `/v1/messages`                                                          |

## Theo SDK và công cụ [#by-sdk-and-tool]

| Client                                                               | Thiết lập                                  | Giá trị                                     |
| -------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------- |
| [OpenAI SDK](/vi/docs/guides/openai-sdk) (Python)                    | `base_url`                                 | `https://api.cheapaimodel.ai/v1`            |
| [OpenAI SDK](/vi/docs/guides/openai-sdk) (TypeScript)                | `baseURL`                                  | `https://api.cheapaimodel.ai/v1`            |
| SDK OpenAI qua biến môi trường                                       | `OPENAI_BASE_URL`                          | `https://api.cheapaimodel.ai/v1`            |
| [LangChain](/vi/docs/guides/langchain) (Python / TypeScript)         | `base_url` / `configuration.baseURL`       | `https://api.cheapaimodel.ai/v1`            |
| [LlamaIndex](/vi/docs/guides/llamaindex)                             | `api_base` trong `OpenAILike`              | `https://api.cheapaimodel.ai/v1`            |
| [Vercel AI SDK](/vi/docs/guides/vercel-ai-sdk)                       | `baseURL` trong `createOpenAICompatible`   | `https://api.cheapaimodel.ai/v1`            |
| [LiteLLM](/vi/docs/guides/litellm)                                   | `api_base` (mô hình `openai/<id>`)         | `https://api.cheapaimodel.ai/v1`            |
| [Anthropic SDK](/vi/docs/guides/anthropic-sdk) (Python / TypeScript) | `base_url` / `baseURL`                     | `https://api.cheapaimodel.ai`               |
| SDK Anthropic qua biến môi trường                                    | `ANTHROPIC_BASE_URL`                       | `https://api.cheapaimodel.ai`               |
| [Claude Code](/vi/docs/guides/claude-code)                           | `ANTHROPIC_BASE_URL`                       | `https://api.cheapaimodel.ai`               |
| [Codex CLI](/vi/docs/guides/codex-cli)                               | `base_url` trong `config.toml`             | `https://api.cheapaimodel.ai/v1`            |
| [Cursor](/vi/docs/guides/cursor)                                     | Override OpenAI Base URL                   | `https://api.cheapaimodel.ai/v1`            |
| [Cline](/vi/docs/guides/cline)                                       | Base URL                                   | `https://api.cheapaimodel.ai/v1`            |
| [Continue](/vi/docs/guides/continue)                                 | `apiBase` trong `config.yaml`              | `https://api.cheapaimodel.ai/v1`            |
| [Zed](/vi/docs/guides/zed)                                           | `api_url` trong `settings.json`            | `https://api.cheapaimodel.ai/v1`            |
| [Aider](/vi/docs/guides/aider)                                       | `OPENAI_API_BASE` hoặc `--openai-api-base` | `https://api.cheapaimodel.ai/v1`            |
| [Open WebUI](/vi/docs/guides/open-webui)                             | URL của kết nối OpenAI API                 | `https://api.cheapaimodel.ai/v1`            |
| [Dify](/vi/docs/guides/dify)                                         | API Base URL (OpenAI-API-compatible)       | `https://api.cheapaimodel.ai/v1`            |
| [n8n](/vi/docs/guides/n8n)                                           | Base URL trong credential OpenAI           | `https://api.cheapaimodel.ai/v1`            |
| [OpenClaw](/vi/docs/guides/openclaw)                                 | `baseUrl` trong `models.providers`         | `https://api.cheapaimodel.ai/v1`            |
| [curl](/vi/docs/guides/curl)                                         | URL đầy đủ                                 | `https://api.cheapaimodel.ai/v1/<endpoint>` |

## Lỗi thường gặp [#common-mistakes]

* **Thêm `/v1` cho client Anthropic.** SDK tự thêm `/v1/messages`, nên yêu cầu bị gửi tới `/v1/v1/messages` và trả về `404` kèm thông báo `Invalid URL (POST /v1/v1/messages)`. Chỉ dùng host, không kèm `/v1`.
* **Thiếu `/v1` cho client OpenAI.** Yêu cầu bị gửi tới `/chat/completions` (không phải đường dẫn API) và trả về `404` với body văn bản thuần `fault filter abort`, không phải JSON. Thêm `/v1`.
* **Đưa cả đường dẫn endpoint vào Base URL.** Đặt `https://api.cheapaimodel.ai/v1`, không phải `https://api.cheapaimodel.ai/v1/chat/completions`; SDK sẽ tự thêm đường dẫn, và đường dẫn bị lặp sẽ trả về `404`.
* **Dùng host của trang web hoặc bảng điều khiển.** `cheapaimodel.ai` và `console.cheapaimodel.ai` chỉ là trang web, không phải API.

Khi Base URL đã đúng, gửi key như mô tả trong [Xác thực và API key](/vi/docs/concepts/authentication).