# Cách dùng API LLM AutoShopee

URL: https://tinhnang.autoshopee.com/autoshopee/llm-api/
Markdown: https://tinhnang.autoshopee.com/autoshopee/llm-api.md

> Hướng dẫn dùng API LLM AutoShopee: nạp tiền bằng QR từ 10.000đ, tạo API key, gọi model atsp-flash qua OpenAI SDK và theo dõi chi phí từng key.

AutoShopee LLM bán API model ngôn ngữ, tính tiền theo token thực dùng, nạp bằng VNĐ. Bạn quản lý số dư, API key và nhật ký gọi tại [console.autoshopee.com](https://console.autoshopee.com/).

> **Lưu ý:**
> Cần biết gọi API (curl, Python, Node.js…) thì mới dùng được. Console không có ô chat để nói chuyện trực tiếp với model.

[Ảnh: Tab Tổng quan của AutoShopee LLM Console: số dư, chi phí 7 ngày, API key và lượt gọi gần nhất]

## Model và bảng giá API LLM AutoShopee

| Model | Dùng cho | Ngữ cảnh |
|---|---|---|
| `atsp-flash` (mặc định) | Chat chăm sóc khách hàng Shopee, trả lời tin nhắn tự động theo kịch bản | 128k |
| `atsp-sflash` | Bóc tách địa chỉ giao hàng, lọc từ khoá nhạy cảm | 32k |

Giá tính riêng cho token vào và token ra (mỗi 1 triệu token), prompt lặp lại được tính giá cache hit rẻ hơn. Token suy luận ẩn của model được tính là token ra. Giá có thể thay đổi, xem giá mới nhất và số token quy đổi theo mức nạp ở tab **Bảng giá** trong console.

[Ảnh: Bảng giá model atsp-flash, atsp-sflash và số token theo mức nạp]

## 1) Nạp tiền bằng mã QR

1. Đăng nhập [console.autoshopee.com](https://console.autoshopee.com/), mở tab **Nạp tiền**.
2. Chọn một mức có sẵn (10.000đ, 20.000đ, 50.000đ, 100.000đ, 200.000đ, 500.000đ) hoặc gõ số tiền vào ô **Mức tuỳ chọn (VNĐ)**, từ 10.000đ đến 50.000.000đ.
3. Bấm **Tạo mã QR nạp tiền**. Màn hình hiện mã VietQR, số tiền và **Nội dung CK bắt buộc**.
4. Quét mã bằng app ngân hàng bất kỳ. Giữ nguyên nội dung chuyển khoản để hệ thống tự cộng tiền vào số dư.

[Ảnh: Chọn mức nạp credit, bấm Tạo mã QR nạp tiền và quét VietQR]

Trạng thái giao dịch xem ở bảng **Lịch sử nạp tiền gần nhất**: Đang chờ hoặc Đã thanh toán. Lỡ đóng trang thì bấm **Mở lại QR** ở dòng đang chờ.

> **Mẹo:**
> Số dư luôn để lớn hơn 0đ để không bị gián đoạn. Số dư và số token quy đổi hiện ở tab **Tổng quan**.

## 2) Tạo API key

1. Mở tab **API Keys**, bấm **Tạo API Key mới**, đặt tên theo ứng dụng sẽ dùng key.
2. Chép key ngay. Key có dạng `sk-...` và chỉ hiện đầy đủ một lần lúc tạo.

Mỗi tài khoản tạo được tối đa 20 key. Từng key có nút bật tắt, cột **Đã dùng (VNĐ)** và nút **Xóa**.

[Ảnh: Tab API Keys: danh sách key, bật tắt, chi phí từng key và Base URL kết nối]

## 3) Gọi API

AutoShopee LLM dùng chuẩn OpenAI: giữ nguyên OpenAI SDK, đổi Base URL và API key.

- Base URL: `https://llm-provider.autoshopee.com/v1`
- Endpoint chat: `/chat/completions`
- Model: `atsp-flash` hoặc `atsp-sflash`

[Ảnh: Tab Hướng dẫn: Base URL, đoạn mẫu cURL, Python, Node.js và lưu ý bảo mật API key]

Ví dụ gọi bằng curl:

```bash
curl https://llm-provider.autoshopee.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "atsp-flash", "messages": [{"role": "user", "content": "Xin chào"}]}'
```

Tab **Hướng dẫn** trong console có thêm đoạn mẫu Python và Node.js.

## 4) Theo dõi chi phí

Tab **Mức sử dụng** ghi từng lượt gọi: thời gian, key, model, token vào (Prompt), token ra (Completion), tổng token và chi phí. Lọc theo key, tên model hoặc khoảng ngày rồi bấm **Lọc**. Cần đối chiếu thì bấm **Xuất CSV**.

[Ảnh: Tab Mức sử dụng: lịch sử từng lượt gọi LLM với token và chi phí, lọc theo key, model, ngày]

Tab **Tổng quan** có biểu đồ chi phí 7 ngày và 5 lượt gọi gần nhất.

Prompt gửi lại giống lần trước được tính giá cache hit, rẻ hơn nhiều so với lần đầu. Đặt phần kịch bản cố định ở đầu prompt để tận dụng điều này.

## *) Bảo mật API key

- Không để lộ key trong code web hay app mobile mà người dùng tải về, không đẩy key lên Git repository công khai.
- Nghi key bị lộ: tắt hoặc xoá key đó ở tab **API Keys** rồi tạo key mới.
- Mỗi ứng dụng một key riêng để biết app nào tiêu bao nhiêu và khoá đúng key khi có sự cố.