KIRA AI API

1. Giới thiệu nền tảng Kira AI

Kira AI API là cổng giao tiếp và kết nối API tập trung hiệu năng cao, bảo mật cao, kết nối trực tiếp đến các dòng mô hình ngôn ngữ lớn (LLM) hàng đầu thế giới hiện nay. Nền tảng được tối ưu hóa chi phí vượt trội, cung cấp giải pháp kết nối White-Label thuần khiết giúp nhà phát triển dễ dàng tích hợp trí tuệ nhân tạo đa dạng vào ứng dụng của mình mà không bị giới hạn bởi một nhà cung cấp đơn lẻ.

Hệ thống hỗ trợ 2 phương thức giao tiếp chính: Trò chuyện trực tuyến (Kira Chatbox) trực tiếp trên trình duyệt và Cổng API kết nối ngoài tương thích hoàn toàn 100% với định dạng chuẩn OpenAI, giúp dễ dàng tích hợp và mở rộng các mô hình AI thông minh.

2. Sử dụng Kira Chatbox (Web Client)

Bạn có thể chat trực tiếp với trợ lý thông minh Kira AI tại tab Kira Chatbox. Tại đây, bạn có thể lựa chọn 4 dòng mô hình thông minh tùy thuộc vào nhu cầu công việc:

• Kira 3.5 Flash: Mô hình mặc định, cực kỳ đa năng, tốc độ phản hồi nhanh như chớp và thông minh vượt trội.
• Kira 3 Flash Preview: Bản thử nghiệm công nghệ mới nhất, tối ưu hiệu suất lập luận và hiểu ngữ cảnh sâu rộng.
• Kira 2.5 Flash: Dòng mô hình ổn định lâu dài, phù hợp cho hầu hết mọi nhu cầu xử lý thông tin thông thường.
• Kira 2.5 Pro: Bản nâng cấp chuyên sâu lý luận logic phức tạp, viết code chuyên nghiệp và phân tích tài liệu dài.

3. Quản lý API Key & Tích hợp lập trình bên thứ 3

Để tích hợp Kira AI vào các công cụ như Cursor, LibreChat, NextChat, OpenWebUI, Obsidian,... bạn cần tạo API Key tại tab Quản lý API Key.

Ví dụ kết nối bằng Node.js / OpenAI SDK:

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://ai.vibewp.vn/api/v1", // Thay đổi domain tương ứng của hệ thống
  apiKey: "kira_YOUR_SECRET_API_KEY"       // Khóa API bạn đã tạo trong bảng điều khiển
});

const completion = await openai.chat.completions.create({
  model: "kira-3.5-flash", // Hỗ trợ: kira-3.5-flash, kira-3-flash-preview, kira-2.5-flash, kira-2.5-pro
  messages: [
    { role: "system", content: "You are a helpful programming assistant." },
    { role: "user", content: "Write a quicksort implementation in Python." }
  ],
  stream: true
});

for await (const chunk of completion) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

Ví dụ gửi yêu cầu bằng cURL:

curl -X POST https://ai.vibewp.vn/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kira_YOUR_SECRET_API_KEY" \
  -d '{
    "model": "kira-3.5-flash",
    "messages": [{"role": "user", "content": "Xin chào Kira AI!"}],
    "temperature": 0.7
  }'

Ví dụ gửi yêu cầu Multimodal (Phân tích hình ảnh):

Cổng API hỗ trợ đồng thời cả chuẩn OpenAI Multimodal và chuẩn Gemini-native (parts):

// Cách 1: Gửi qua mảng content chuẩn OpenAI (Khuyên dùng)
const responseOpenAI = await fetch("https://ai.vibewp.vn/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_KIRA_API_KEY"
  },
  body: JSON.stringify({
    model: "kira-3.5-flash",
    messages: [{
      role: "user",
      content: [
        { type: "text", text: "Mô tả bức ảnh này" },
        { type: "image_url", image_url: { url: "data:image/jpeg;base64,/9j/..." } }
      ]
    }]
  })
});

// Cách 2: Gửi qua mảng parts chuẩn Gemini gốc
const responseGemini = await fetch("https://ai.vibewp.vn/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_KIRA_API_KEY"
  },
  body: JSON.stringify({
    model: "kira-3.5-flash",
    messages: [{
      role: "user",
      parts: [
        { text: "Mô tả bức ảnh này" },
        { inlineData: { mimeType: "image/jpeg", data: "/9j/..." } }
      ]
    }]
  })
});

3.5. Hướng dẫn sử dụng Image Generation API (Tạo ảnh)

Kira AI hỗ trợ tạo hình ảnh thông qua API tương thích OpenAI tại endpoint /images/generations. Bạn có thể sử dụng các dòng mô hình sau:

• kira-3.1-flash-image-preview: Tạo ảnh cực nhanh, hỗ trợ phác thảo ý tưởng tốt.
• kira-3-pro-image-preview: Tạo ảnh chất lượng cao, chi tiết sắc nét và chân thực.
• kira-2.5-flash-image: Tạo ảnh tốc độ cao và ổn định.

Ví dụ tạo ảnh bằng cURL:

curl -X POST https://ai.vibewp.vn/api/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kira_YOUR_SECRET_API_KEY" \
  -d '{
    "model": "kira-3-pro-image-preview",
    "prompt": "A beautiful cyber-punk city in rain, neon light reflections, high resolution",
    "aspect_ratio": "16:9"
  }'

Ví dụ kết nối bằng Node.js:

const response = await fetch("https://ai.vibewp.vn/api/v1/images/generations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer kira_YOUR_SECRET_API_KEY"
  },
  body: JSON.stringify({
    model: "kira-3.1-flash-image-preview",
    prompt: "Con mèo con dễ thương nằm ngủ trên thảm cỏ xanh",
    aspect_ratio: "1:1"
  })
});

const result = await response.json();
console.log(result.data[0].b64_json); // Base64 string của hình ảnh
console.log(result.data[0].mime_type); // Định dạng ảnh (ví dụ: image/jpeg)

3.8. Hướng dẫn sử dụng Video Generation API (Tạo video)

Kira AI hỗ trợ tạo video bằng trí tuệ nhân tạo thông qua mô hình cao cấp Kira 3.1 Generate (kira-3.1-generate-001). Vì quá trình dựng video là bất đồng bộ và mất thời gian (khoảng 1-2 phút), API được thiết kế theo mô hình 2 bước: Khởi tạo tiến trình LRO (Long-Running Operation) và Thăm dò trạng thái (Polling).

Ví dụ tạo video bằng cURL:

Bước 1: Gửi yêu cầu khởi tạo video

curl -X POST https://ai.vibewp.vn/api/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kira_YOUR_SECRET_API_KEY" \
  -d '{
    "model": "kira-3.1-generate-001",
    "prompt": "Một chú rồng nhỏ dễ thương đang tập bay qua hẻm núi tuyết hùng vĩ, cinematic",
    "aspect_ratio": "16:9",
    "duration_seconds": 6
  }'

Bước 2: Gửi GET thăm dò định kỳ bằng UUID nhận được từ Bước 1

curl -X GET https://ai.vibewp.vn/api/v1/videos/operations/UUID_NHAN_DUOC_TU_BUOC_1 \
  -H "Authorization: Bearer kira_YOUR_SECRET_API_KEY"

Ví dụ kết nối bằng Node.js:

// 1. Khởi tạo tác vụ tạo video
const initResponse = await fetch("https://ai.vibewp.vn/api/v1/videos/generations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer kira_YOUR_SECRET_API_KEY"
  },
  body: JSON.stringify({
    model: "kira-3.1-generate-001",
    prompt: "A cute golden retriever playing with flowers in a sunny park, slow motion",
    aspect_ratio: "16:9",
    duration_seconds: 6
  })
});

const initData = await initResponse.json();
const videoUuid = initData.id; // Lấy UUID của operation
console.log(`Đang khởi tạo video. Operation ID: ${videoUuid}`);

// 2. Định kỳ kiểm tra (Polling) cho tới khi hoàn tất
const pollStatus = async () => {
  const pollRes = await fetch(`https://ai.vibewp.vn/api/v1/videos/operations/${videoUuid}`, {
    headers: { "Authorization": "Bearer kira_YOUR_SECRET_API_KEY" }
  });
  
  const pollData = await pollRes.json();
  
  if (pollData.done) {
    if (pollData.status === "completed") {
      console.log("Tạo video thành công!");
      console.log("Video Base64:", pollData.data[0].b64_json);
      console.log("Mime Type:", pollData.data[0].mime_type);
    } else {
      console.error("Lỗi:", pollData.error);
    }
  } else {
    console.log("AI đang dựng video, thử lại sau 10 giây...");
    setTimeout(pollStatus, 10000);
  }
};

setTimeout(pollStatus, 10000);

4. Cơ chế tính hạn ngạch Token hàng ngày (Daily Token Limit)

Để duy trì hiệu năng ổn định và tiết kiệm chi phí hệ thống, mỗi người dùng sẽ được cấu hình một Hạn mức Token hàng ngày cụ thể. Nếu tài khoản của bạn hiển thị trạng thái "Không giới hạn", bạn có thể tự do gửi truy vấn không giới hạn số lượng.

• Hạn mức Token ngày được làm mới tự động vào 00:00 hàng ngày.
• Bạn có thể kiểm tra trực quan số lượng Token còn lại trong ngày tại hộp chỉ báo ở thanh menu góc bên trái.