Tài liệu tích hợp AI API
Một base URL gateway cho chat, image và video async. Ứng dụng của bạn gọi AI API với key sk_vietai_… — billing tự động theo ví.
⚡
Quickstart
cURL chat & video trong 2 phút.
Xem bên dưới →◈
Swagger UI
Try it out trực tiếp trên trình duyệt.
Mở API Reference →⌘
Console
Playground, API keys, billing logs.
Đăng nhập →https://aiapi.io.vn/v1
Xác thực
Header Authorization: Bearer sk_vietai_…. Key tạo tại Console → API Keys sau khi đăng nhập.
Bảo mật: Không nhúng key vào frontend công khai. Ứng dụng production nên gọi qua backend riêng.
Quickstart · Chat
curl -X POST https://aiapi.io.vn/v1/chat/completions \
-H "Authorization: Bearer sk_vietai_..." \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [{"role":"user","content":"Xin chào AI API"}]
}'
Sinh hình ảnh
POST /v1/images/generations
{
"model": "gen4_image" | "gen4_image_turbo" | "flux_pro_runway" | "seedream_5_pro",
"prompt": "string",
"size": "1024x1024"
}
Sinh video (async)
POST /v1/videos/generations
{
"model": "google_veo_3_1_lite" | "google:veo@3.1-lite" | "bfl_flux_3_video",
"prompt": "string",
"duration": 4 | 6 | 8,
"size": "1280x720",
"generate_audio": true
}
GET /v1/videos/jobs/{taskUUID}
Catalog video (CMS)
Catalog & OpenAPI
GET /v1/models
GET /api/public/models
GET /api/public/docs/catalog
GET /api/public/docs/openapi.json
GET /api/public/docs/models/{id}
Credit & giới hạn
$1 ≈ 1.000 credits (25₫/credit). Chi phí theo model trên bảng giá và danh mục. Mặc định 60 req/phút/key.
Mã lỗi
401 invalid_api_key
402 insufficient_balance
429 rate_limit_exceeded
202 processing (video — poll job)
5xx provider_error
Hỗ trợ tích hợp? Đăng ký và mở ticket từ Console.