Source: https://ailoot.ai/docs/vi/ Canonical: https://ailoot.ai/docs/vi/ Language: vi [Bắt đầu](https://ailoot.ai/docs/vi/) # Bắt đầu nhanh — Khóa API, giá và yêu cầu đầu tiên [Markdown](https://ailoot.ai/docs/vi/index.md) Nhận câu trả lời đầu tiên từ mô hình qua Ailoot chỉ trong vài phút: khóa, địa chỉ và một yêu cầu. Ailoot là API chung cho các mô hình AI của nhiều công ty: OpenAI, Anthropic, Google, xAI, DeepSeek, Alibaba, Moonshot, Z.ai, MiniMax, NVIDIA, Meta, Poolside và TypeSafe. Một khóa, một số dư bằng đô la. Danh mục có 1256 thẻ mô hình và 2692 phương thức có tài liệu hướng dẫn. Các mã định danh gọi thay thế hoặc bí danh được liệt kê trong phương thức đã chọn, nếu có. Ailoot hỗ trợ ba định dạng API: OpenAI, Anthropic và Gemini. Vì vậy, bạn có thể dùng SDK có sẵn và hầu hết ứng dụng cho phép đặt địa chỉ API riêng: Claude Code, Codex CLI, Cline, Cursor, Open WebUI, n8n cùng hàng chục ứng dụng khác. | Cách dùng | Khi nào phù hợp | | --- | --- | | [Yêu cầu HTTP](https://ailoot.ai/docs/vi/connect/curl/) | Bất kỳ ngôn ngữ nào, không cần thư viện phụ thuộc, kiểm tra khóa nhanh | | [OpenAI SDK](https://ailoot.ai/docs/vi/connect/openai-sdk/) | Python và Node.js; mọi mô hình trong danh mục có định dạng OpenAI | | [Anthropic SDK](https://ailoot.ai/docs/vi/connect/anthropic-sdk/) | Claude và các mô hình khác có định dạng Messages | | [Ứng dụng có sẵn](https://ailoot.ai/integrations/vi/) | 85 tác nhân, trình soạn thảo và ứng dụng trò chuyện: 77 ứng dụng có cấu hình sẵn, 8 ứng dụng còn lại đang được kiểm tra | Cần một chương trình cụ thể? Hãy mở [danh mục tích hợp](https://ailoot.ai/integrations/vi/): tại đó, mỗi ứng dụng đều có hướng dẫn nơi nhập địa chỉ và khóa, cùng cấu hình sẵn để sao chép. ## [](https://ailoot.ai/docs/vi/#key)Lấy khóa 1. **Đăng ký** Tạo tài khoản tại [ailoot.ai/register](https://ailoot.ai/register). Sau đó đăng nhập qua [ailoot.ai/login](https://ailoot.ai/login). 2. **Nạp thêm số dư** Trong trang quản lý tài khoản, mở mục “Biểu phí”: nạp tiền một lần từ $18 hoặc đăng ký gói có thưởng thêm vào số dư. Xem thêm: [nạp tiền](https://ailoot.ai/docs/vi/billing/topup/) và [gói đăng ký](https://ailoot.ai/docs/vi/billing/subscriptions/). 3. **Tạo khóa API** Trong trang quản lý tài khoản, mở mục khóa và tạo khóa mới. Khóa bắt đầu bằng `sk-`. Bạn có thể sao chép khóa trong mục khóa của trang quản lý tài khoản; hãy giữ khóa kín như mật khẩu. Lưu khóa trong biến môi trường ```bash export AILOOT_API_KEY="sk-..." # kiểm tra: phải nhận được danh sách mô hình curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300 ``` ## [](https://ailoot.ai/docs/vi/#first-request)Gửi yêu cầu đầu tiên Địa chỉ API — `https://api.ailoot.ai`. Với SDK theo định dạng OpenAI, địa chỉ gốc là `https://api.ailoot.ai/v1`, còn với Anthropic và Gemini là `https://api.ailoot.ai` không có hậu tố: các SDK này tự thêm đường dẫn. ```bash curl https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "messages": [ {"role": "user", "content": "Giải thích API là gì trong hai câu."} ] }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"], ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "Giải thích API là gì trong hai câu."}], ) print(resp.choices[0].message.content) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY, }); const resp = await client.chat.completions.create({ model: "claude-sonnet-5-5", messages: [{ role: "user", content: "Giải thích API là gì trong hai câu." }], }); console.log(resp.choices[0].message.content); ``` ```python import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # không có /v1: SDK tự thêm /v1/messages api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Giải thích API là gì trong hai câu."}], ) print(msg.content[0].text) ``` Phản hồi sẽ có định dạng quen thuộc. Khối `usage` cho biết số token dùng cho câu hỏi và câu trả lời: tiền được tính theo những số liệu này. 200 OK ```json { "id": "chatcmpl-8f2c…", "object": "chat.completion", "created": 1790812800, "model": "claude-sonnet-5-5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "API là quy ước về cách một chương trình yêu cầu chương trình khác thực hiện một việc…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 21, "completion_tokens": 48, "total_tokens": 69 } } ``` ## [](https://ailoot.ai/docs/vi/#streaming)Phản hồi dạng luồng Khi dùng `"stream": true` phản hồi được gửi theo định dạng Server-Sent Events như API gốc, nên SDK và ứng dụng khách xử lý được mà không cần sửa đổi. Với OpenAI SDK, bạn có thể yêu cầu số liệu `usage` tổng kết trong sự kiện cuối cùng. Ailoot gửi câu trả lời văn bản tính phí sau khi tính chi phí. Vì vậy, khi dùng `stream: true` định dạng vẫn là luồng (SSE), nhưng văn bản được gửi trong một khối sau khi mô hình hoàn tất, thay vì từng từ. Nếu quá trình chuẩn bị câu trả lời kéo dài hơn khoảng 15 giây, các luồng Chat Completions, Responses và Messages sẽ gửi trước các dòng điều khiển `: ping` (khoảng mỗi 10 giây), sau đó là dòng `: ailoot-charged-usd …` cho biết số tiền đã trừ, rồi đến dữ liệu trả về. SDK bỏ qua các dòng điều khiển này. ```python stream = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "Viết một bài haiku về mưa"}], stream=True, stream_options={"include_usage": True}, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` ```js const stream = await client.chat.completions.create({ model: "gpt-6.1-sol", messages: [{ role: "user", content: "Viết một bài haiku về mưa" }], stream: true, stream_options: { include_usage: true }, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ```bash curl -N https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "stream": true, "messages": [{"role": "user", "content": "Viết một bài haiku về mưa"}]}' ``` ## [](https://ailoot.ai/docs/vi/#models)Chọn mô hình Trường `model` — mã định danh chính xác từ [danh mục mô hình](https://ailoot.ai/models/vi/) hoặc từ phản hồi của `GET /v1/models`. Nhiều mô hình có bí danh ngắn, ví dụ `claude-sonnet-latest` hoặc `qwen`. Danh mục cho biết bí danh hiện trỏ đến mô hình nào; để kết quả có thể tái lập, hãy dùng ID chính xác. | Tác vụ | Bắt đầu từ đâu | | --- | --- | | Lập trình và tác nhân | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` | | Nhanh và tiết kiệm | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` | | Ngữ cảnh dài tới 1M token | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` | | Hình ảnh | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` | Không phải mô hình nào cũng có mọi định dạng. Ví dụ, các mô hình Gemini hoạt động qua Anthropic Messages và định dạng Gemini gốc, còn qua OpenAI Chat chỉ có `gemini-3.6-flash`. Xem các định dạng mà mô hình hỗ trợ trong [danh mục](https://ailoot.ai/models/vi/). ## [](https://ailoot.ai/docs/vi/#next)Bước tiếp theo [**Cách hoạt động** Đường đi của yêu cầu, giữ tiền và trừ tiền, lỗi](https://ailoot.ai/docs/vi/how-it-works/) [**Khả năng tương thích** Các định dạng và ứng dụng khách được hỗ trợ](https://ailoot.ai/docs/vi/compatibility/) [**Tích hợp** 77 ứng dụng có cấu hình sẵn](https://ailoot.ai/integrations/vi/) [**Lỗi và giới hạn** Mã phản hồi và cách xử lý](https://ailoot.ai/docs/vi/errors/) Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai) ## Khóa API, giá và yêu cầu đầu tiên ### Thanh toán chi phí sử dụng API Ailoot như thế nào? Trong trang quản lý tài khoản, mở mục “Biểu phí”: nạp tiền một lần từ $18 hoặc đăng ký gói có thưởng thêm vào số dư. Xem thêm: nạp tiền và gói đăng ký. Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn. ## Công ty và danh mục dự án của công ty Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng. ## Mua token với giá ưu đãi. Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token. Thuê bao Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn. Mã giảm đến 50% Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng. Chi phí trong lịch sử Mô hình, token và số tiền được lưu cho mỗi yêu cầu. [Chọn gói thuê bao](https://ailoot.ai/docs/vi/billing/subscriptions/) · [Xem giá mô hình](https://ailoot.ai/models/vi/) ## Kết nối API vào sản phẩm bạn đang bán. SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại. Ứng dụng thương mại Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ. Giấy phép bán lại Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản. Tài liệu trên website Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối. [Yêu cầu giấy phép bán lại](mailto:support@ailoot.ai) · [Đề nghị giao kết và thỏa thuận cấp phép](https://ailoot.ai/legal/offer?lang=vi) ## Câu hỏi Làm sao gửi yêu cầu API đầu tiên? Tạo khóa API Ailoot. Đặt https://api.ailoot.ai/v1 cho OpenAI SDK, hoặc https://api.ailoot.ai cho Anthropic và Gemini SDK. GET /v1/models miễn phí và liệt kê các mô hình mà khóa của bạn có thể truy cập; sau đó dùng ví dụ cho mô hình và phương thức API đã chọn. Tôi nên dùng khóa API nào? Dùng khóa API Ailoot từ tài khoản của bạn trong trường xác thực của định dạng ứng dụng khách đã chọn. Gửi GET /v1/models với cùng khóa để kiểm tra quyền truy cập mô hình miễn phí; khóa của dịch vụ khác không cấp quyền truy cập Ailoot. Cần kiểm tra gì nếu yêu cầu đầu tiên thất bại? Đối chiếu địa chỉ API, khóa API Ailoot, ID mô hình chính xác và phương thức API với thẻ mô hình và ví dụ yêu cầu. Đọc lỗi trả về; nếu cần trợ giúp, gửi lỗi và ID yêu cầu đến support@ailoot.ai mà không gửi khóa API. Thuê bao mang lại gì? Giảm giá mua token cho nhu cầu thường xuyên. Chọn gói theo khối lượng yêu cầu; điều khoản và giá thuê bao hiển thị khi đăng ký. Làm sao áp dụng mã giảm đến 50%? Nhập mã khuyến mãi khi mua token. Tổng tiền được tính lại theo điều kiện chương trình; mức giảm hiển thị trước khi thanh toán. ## Ailoot · Công ty và danh mục dự án của công ty Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục. Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng. Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.