# Welcome
Chào mừng bạn đến với tài liệu dành cho Nhà phát triển (Developer Documentation) của **HubAPI**.
**HubAPI** (`https://api.hubapi.vn`) không chỉ là một trạm trung chuyển AI thông thường. Chúng tôi là một **Universal Multi-modal AI Router** (Cổng định tuyến AI Đa phương thức toàn diện).
Với một tài khoản và một API Key duy nhất, bạn có thể tích hợp **toàn bộ sức mạnh AI của thế giới** vào ứng dụng của mình: từ các LLM suy luận logic xuất sắc nhất (OpenAI o1, Claude 3.7, Gemini 2.0), khả năng phân tích thị giác (Vision), cho đến tạo hình ảnh (Image Generation) và tạo video (Video Generation) chất lượng điện ảnh.
{% hint style="success" %}
**🔥 100% Tương thích chuẩn OpenAI SDK** Điểm ăn tiền nhất của HubAPI là bạn **không cần học thêm bất kỳ SDK nào mới**. Bạn muốn gọi Claude 3.7? Dùng thư viện OpenAI. Bạn muốn tạo ảnh bằng Midjourney/Stable Diffusion hay tạo Video? Vẫn dùng thư viện OpenAI. Chỉ cần đổi `base_url` thành của HubAPI!
{% endhint %}
***
### 💡 Tại sao Developer "phát cuồng" vì HubAPI?
Việc tích hợp nhiều loại AI (Text, Image, Video) từ nhiều hãng khác nhau (OpenAI, Google, Anthropic, Midjourney, Runway...) vào một dự án thường biến code-base của bạn thành một "mớ bòng bong" với hàng tá SDK, format JSON khác nhau và hóa đơn thanh toán rải rác. HubAPI giải quyết triệt để vấn đề này:
#### 1. 🧩 Một API - Đa phương thức (All-in-One Modality)
* **Văn bản & Logic (Chat):** Định dạng `messages` chuẩn chỉ.
* **Thị giác (Vision):** Gửi ảnh dạng Base64 hoặc URL để AI phân tích.
* **Tạo ảnh (Image):** Gọi các model sinh ảnh qua endpoint `/v1/images/generations`.
* **Tạo Video (Video):** Hỗ trợ các model sinh video hàng đầu qua endpoint chuẩn hóa.
#### 2. 💳 Thanh toán tập trung (Single Wallet)
Quên đi việc phải add thẻ Visa vào 10 nền tảng khác nhau hay loay hoay lách luật thanh toán quốc tế. Tại HubAPI, bạn nạp Credit một lần và dùng chung cho mọi model: từ việc gen 1 bài viết bằng Claude, đến vẽ 1 bức ảnh bằng DALL-E 3 hay render 1 đoạn video bằng Sora/Runway. Chi phí được tính chính xác theo giá gốc (Pay-as-you-go).
#### 3. ⚡ Tối ưu hóa độ trễ & Chống "Sập" (High Availability)
Hệ thống Router của chúng tôi sử dụng cơ chế Load Balancing thông minh. Nếu server của Anthropic hay OpenAI bị quá tải (thường xuyên trả về lỗi 500, 529), HubAPI sẽ tự động retry hoặc fallback sang các node dự phòng, đảm bảo ứng dụng của bạn luôn `uptime`. Hỗ trợ hoàn hảo streaming (`stream: true`) độ trễ cực thấp.
#### 4. 🛡️ Vượt rào cản địa lý (Geo-Unlocking)
Không còn nỗi lo lỗi *“API is not available in your country”* khi gọi API của Claude hay Gemini. Request của bạn được mã hóa và định tuyến qua mạng lưới máy chủ toàn cầu của HubAPI.
***
### 🌍 Hệ sinh thái Model khổng lồ
Chúng tôi liên tục cập nhật các model mới nhất và mạnh nhất (SOTA - State of the Art) ngay khi chúng vừa ra mắt.
#### 🧠 Xử lý Ngôn ngữ & Logic (LLMs)
* **OpenAI:** `gpt-4o`, dòng suy luận sâu `o1`, `o3-mini`, `gpt-4-turbo`...
* **Anthropic:** `claude-3-7-sonnet` (Vua coding hiện tại), `claude-3-5-haiku`, `claude-3-opus`.
* **Google:** `gemini-2.0-flash`, `gemini-1.5-pro` (Cửa sổ ngữ cảnh 2 triệu token).
* **Mã nguồn mở (OSS):** `llama-3.3-70b`, `mixtral-8x22b`, `qwen-2.5`...
#### 👁️ Xử lý Thị giác (Vision)
* `gpt-4o-vision`, `claude-3-7-sonnet-vision`, `gemini-2.0-flash-vision` (Nhận diện hình ảnh, đọc biểu đồ, OCR tài liệu).
#### 🎨 Tạo Hình Ảnh (Image Generation)
* **Google:** `imagen-3` (Mô hình sinh ảnh mới nhất của Google, cực mạnh về độ chân thực và khả năng render text/chữ viết vào trong ảnh).
* **OpenAI:** `dall-e-3` (Bám sát prompt xuất sắc, nét vẽ đa dạng).
* **Midjourney:** `midjourney` (Mô hình có tính nghệ thuật cao nhất thế giới hiện nay - *Được HubAPI chuẩn hóa hoàn toàn qua API RESTful thay vì phải dùng Discord*).
* **Black Forest Labs:** `flux-1.1-pro`, `flux-schnell` (Dòng model Flux đang làm mưa làm gió cộng đồng mã nguồn mở với tốc độ sinh ảnh và độ chân thực khủng khiếp).
* **Stability AI:** `stable-diffusion-3`, `sdxl` (Tối ưu cho các tác vụ cần tùy biến cao).
#### 🎬 Tạo Video (Video Generation)
* Hỗ trợ gọi các model sinh video đỉnh cao như `sora` (OpenAI), `runway-gen3`, `luma-dream-machine`, `kling` thông qua bộ API chuẩn hóa của HubAPI.
👉 *Xem danh sách Model đầy đủ và biểu phí theo từng Token/Image/Video tại đây.*
***
### ⚙️ Kiến trúc hoạt động (How it works)
Mọi Request gửi đến HubAPI đều được "phiên dịch" ngầm một cách hoàn hảo:
```mermaid
sequenceDiagram
participant App as Ứng dụng của Dev
participant Hub as 🚦 HubAPI Router
participant LLM as OpenAI / Anthropic / Midjourney...
App->>Hub: Gửi Request (Format OpenAI) + Model ID
Note over Hub: Parse JSON, Xác thực Key & Kiểm tra số dư
Hub->>LLM: Translate sang Native API của hãng
LLM-->>Hub: Trả kết quả (Text / Image URL / Video URL)
Note over Hub: Chuẩn hóa lại thành format OpenAI
Hub-->>App: Trả Response tức thì cho Ứng dụng
Note over Hub: ⚡ Background Task:
Tính toán Usage, Trừ tiền Credit & Lưu thống kê
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.hubapi.vn/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.