Tài liệu tích hợp AI API

Cổng kết nối chuẩn quốc tế cho chat, image và video. Ứng dụng của bạn chỉ cần gọi AI API với key sk_vietai_… — không phải quản lý nhiều nhà cung cấp. Base URL:

https://aiapi.io.vn/v1

Xác thực

Sử dụng API key theo header Authorization: Bearer sk_vietai_…. Khoá được sinh tại trang quản lý sau khi đăng nhập.

Quickstart · Chat completions

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"}]
  }'

Endpoints · Sinh hình ảnh

POST /v1/images/generations
{
  "model": "gen4_image" | "gen4_image_turbo"
         | "flux_pro_runway" | "seedream_5_pro",
  "prompt": "string",
  "size": "1024x1024"
}

Endpoints · Sinh video

POST /v1/images/generations   // modality video qua model id
{
  "model": "gen4_5" | "gen4_turbo" | "gen3a_turbo"
         | "google_veo_3_1" | "seedance_2" | "kling_v3_turbo",
  "prompt": "string"
}

Danh sách model live: models.html hoặc GET /v1/models.

Catalog & Playground

GET  /v1/models
GET  /api/public/models          // catalog công khai (SEO / marketing)
GET  /api/v1/client/models       // catalog sau đăng nhập

Âm thanh & Avatar

Các model TTS / SFX / Avatar nằm trong catalog (eleven_tts_v2, gwm1_avatars, …). Gọi qua cùng gateway với model id tương ứng — xem danh mục mô hình.

Trang quản lý

Trang quản lý: https://console.aiapi.io.vn (local: http://127.0.0.1:4200).

Thông báo tự động

Hệ thống có thể gửi thông báo tự động về sự kiện tới địa chỉ của bạn (nếu cấu hình). Chi tiết xem trên trang quản lý.

Credit & Giới hạn sử dụng

$1 ≈ 1.000 credits (25₫/credit). Chi phí mỗi model được tính tự động và hiển thị trong bảng giá và danh mục. Mặc định: tối đa 60 lần gọi / phút / key.

Mã lỗi

401  invalid_api_key
402  insufficient_balance
429  rate_limit_exceeded
5xx  provider_error