OpenAI-compatible

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í.

Base URL gateway:

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)

Đang tải catalog…

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.