> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cổng API AI: truy cập mô hình, tính phí và yêu cầu đầu tiên

> Hiểu vai trò của cổng API AI và kiểm tra truy cập bằng khóa nền tảng, URL cơ sở đầy đủ cùng nhật ký sử dụng và quyết toán.

**Cổng API AI** nằm giữa ứng dụng và nhà cung cấp mô hình. Cổng xác thực yêu cầu, chuyển đến mô hình được hỗ trợ và trả kết quả qua giao diện đã mô tả trong tài liệu. Cách này có thể giảm cấu hình lặp lại và tập trung theo dõi các lượt sử dụng được hỗ trợ. Nó không làm cho mọi mô hình có cùng hành vi.

Dịch vụ OpenAPI có thể có gói đăng ký, cách xác thực và điểm cuối riêng; không nên mặc định gọi nó như mô hình trò chuyện.

## So sánh với kết nối trực tiếp

Kết nối trực tiếp có thể phù hợp khi ứng dụng chỉ cần các tính năng gốc của một nhà cung cấp. Cổng là lựa chọn đáng xem xét khi đánh giá nhiều dòng mô hình hoặc muốn tập trung quản lý khóa và mức sử dụng. Hãy kiểm tra phạm vi hỗ trợ thực tế trước khi chuyển lưu lượng.

| Tiêu chí | Kết nối trực tiếp | Cần kiểm tra ở cổng |
| - | - | - |
| Ứng dụng khách | Theo API từng nhà cung cấp | Điểm cuối và hành vi SDK được hỗ trợ |
| Tính năng | Tài liệu hiện tại của nhà cung cấp | Tính năng thực sự được cung cấp cho mô hình đã chọn |
| Chi phí | Đối chiếu từng tài khoản | Giá, nhóm áp dụng và mức tiêu thụ đã quyết toán |
| Vận hành | Xử lý lỗi nhà cung cấp | Kiểm tra thêm lỗi cổng, hết thời gian và giới hạn |

URL cơ sở đầy đủ cho mô hình tương thích OpenAI của Rock API là `https://rockapi.ai/v1`. Khả năng tương thích áp dụng cho mô hình và yêu cầu được hỗ trợ. Một URL chung không tự bảo đảm chuyển đổi dự phòng, câu trả lời giống nhau hoặc mọi tính năng gốc.

## Gửi yêu cầu đầu tiên với vai trò người mua

1. Mở [danh mục mô hình và giá hiện tại](https://rockapi.ai/pricing), chọn mô hình hỗ trợ trò chuyện và sao chép đúng ID. Kiểm tra quyền của tài khoản và nhóm đã chọn.
2. [Tạo tài khoản](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=docs_launch), kiểm tra yêu cầu số dư và tạo khóa tại [trang khóa API](https://rockapi.ai/keys). Lưu khóa phía máy chủ trong `ROCK_API_KEY`.
3. Đặt ID đã sao chép vào `ROCK_API_MODEL`. SDK dùng URL cơ sở `https://rockapi.ai/v1`; curl gọi điểm cuối đầy đủ bên dưới.
4. Bắt đầu bằng văn bản ngắn trước khi thêm công cụ, hình ảnh hoặc truyền luồng.

```bash theme={null}
curl --fail-with-body https://rockapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$ROCK_API_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Hãy trả lời xin chào.\"}]}"
```

Cần đặt cả hai biến trong môi trường cục bộ trước khi chạy. ID phụ thuộc danh mục và quyền tài khoản; ví dụ không cam kết một mô hình cụ thể luôn khả dụng. Người mua chỉ cần khóa nền tảng và mô hình có quyền truy cập, không cần cấu hình kênh nhà cung cấp phía trên.

## Kiểm tra phản hồi và khoản phí cuối cùng

Xem trạng thái HTTP, nội dung, mô hình và thông tin sử dụng trả về. Tìm bản ghi tương ứng trong bảng điều khiển để đối chiếu nhóm, loại sử dụng và mức tiêu thụ đã quyết toán. [Hướng dẫn tính phí](https://docs.rockapi.ai/vi/pricing-and-billing.md) phân biệt tính theo sử dụng, theo lượt và động. Khoản tạm giữ có thể khác phí cuối cùng; không có mức giảm cố định áp dụng cho mọi mô hình.

Với `401` hoặc `403`, kiểm tra khóa và quyền; với `400` hoặc `404`, kiểm tra mô hình, nội dung và đường dẫn. Với `429`, xem hạn mức và giới hạn tốc độ trước khi thử lại. Giữ thời điểm và ID yêu cầu nếu có, loại bỏ bí mật rồi tra [lỗi và giới hạn](https://docs.rockapi.ai/vi/errors-and-rate-limits.md).

Khi yêu cầu tối thiểu thành công, dùng [hướng dẫn kiểm nhận khi chuyển API](https://docs.rockapi.ai/vi/blog/buyers/openai-compatible-api.md) để thử tính năng ứng dụng thực sự sử dụng. Đọc [bảo mật và quyền riêng tư](https://docs.rockapi.ai/vi/security-and-privacy.md) cùng điều khoản áp dụng trước khi gửi dữ liệu riêng qua một bên trung gian mới.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.