Tài liệu hướng dẫn tích hợp API

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://kiraai.vn/api/v1", 
  apiKey: "YOUR_KIRA_API_KEY" 
});

const completion = await openai.chat.completions.create({
  model: "kira-3.5-flash",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Xin chào Kira AI!" }
  ]
});

console.log(completion.choices[0].message.content);

const completion = await openai.chat.completions.create({
  model: "kira-3.5-flash",
  messages: [
    {
      role: "user",
      content: [
        { type: "text", text: "Mô tả chi tiết hình ảnh này" },
        {
          type: "image_url",
          image_url: {
            url: "https://example.com/photo.jpg"
          }
        }
      ]
    }
  ]
});

console.log(completion.choices[0].message.content);

import fs from "fs";

// Đọc file ảnh và chuyển sang base64
const imageBuffer = fs.readFileSync("./photo.jpg");
const base64Image = imageBuffer.toString("base64");

const completion = await openai.chat.completions.create({
  model: "kira-3.5-flash",
  messages: [
    {
      role: "user",
      content: [
        { type: "text", text: "Ảnh này chụp gì?" },
        {
          type: "image_url",
          image_url: {
            url: `data:image/jpeg;base64,${base64Image}`
          }
        }
      ]
    }
  ]
});

import base64
from openai import OpenAI

client = OpenAI(
    base_url="https://kiraai.vn/api/v1",
    api_key="YOUR_KIRA_API_KEY"
)

# Cách 1: Gửi URL ảnh
response = client.chat.completions.create(
    model="kira-3.5-flash",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Mô tả hình ảnh này"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/photo.jpg"
                    }
                }
            ]
        }
    ]
)

print(response.choices[0].message.content)

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

{
  "created": 1726000000,
  "model": "kira-3.0-image",
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA... [chuỗi Base64 của ảnh]",
      "mime_type": "image/png"
    }
  ],
  "description": null
}

import fs from "fs";

const response = await fetch("https://kiraai.vn/api/v1/images/generations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_KIRA_API_KEY"
  },
  body: JSON.stringify({
    model: "kira-3.0-image",
    prompt: "A beautiful cyber-punk city in rain, neon light reflections, high resolution",
    aspect_ratio: "16:9"
  })
});

const result = await response.json();
const buffer = Buffer.from(result.data[0].b64_json, "base64");
fs.writeFileSync("output.png", buffer);
console.log("✅ Đã lưu hình ảnh vào output.png");

import requests
import base64

response = requests.post(
    "https://kiraai.vn/api/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_KIRA_API_KEY"},
    json={
        "model": "kira-3.0-image",
        "prompt": "A beautiful cyber-punk city in rain, neon light reflections, high resolution",
        "aspect_ratio": "16:9"
    }
)

data = response.json()
image_bytes = base64.b64decode(data["data"][0]["b64_json"])
with open("output.png", "wb") as f:
    f.write(image_bytes)
print("✅ Đã lưu hình ảnh vào output.png")

curl -X POST https://kiraai.vn/api/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KIRA_API_KEY" \
  -d '{
    "model": "kira-3.0-flash-tts",
    "input": "Chào mừng bạn đến với hệ sinh thái trí tuệ nhân tạo Kira AI.",
    "voice": "alloy"
  }' --output output.mp3

import fs from "fs";
import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://kiraai.vn/api/v1",
  apiKey: "YOUR_KIRA_API_KEY"
});

const mp3 = await openai.audio.speech.create({
  model: "kira-3.0-flash-tts",
  voice: "alloy",
  input: "Chào mừng bạn đến với hệ sinh thái trí tuệ nhân tạo Kira AI."
});

const buffer = Buffer.from(await mp3.arrayBuffer());
await fs.promises.writeFile("output.mp3", buffer);
console.log("✅ Đã lưu tệp âm thanh vào output.mp3");

# Cách 1: Sử dụng thư viện requests
import requests

response = requests.post(
    "https://kiraai.vn/api/v1/audio/speech",
    headers={"Authorization": "Bearer YOUR_KIRA_API_KEY"},
    json={
        "model": "kira-3.0-flash-tts",
        "input": "Chào mừng bạn đến với hệ sinh thái trí tuệ nhân tạo Kira AI.",
        "voice": "alloy"
    }
)

with open("output.mp3", "wb") as f:
    f.write(response.content)
print("✅ Đã lưu tệp âm thanh vào output.mp3")

# Cách 2: Sử dụng OpenAI SDK
# from openai import OpenAI
# client = OpenAI(base_url="https://kiraai.vn/api/v1", api_key="YOUR_KIRA_API_KEY")
# response = client.audio.speech.create(model="kira-3.0-flash-tts", voice="alloy", input="...")
# response.stream_to_file("output.mp3")

curl -X POST https://kiraai.vn/api/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KIRA_API_KEY" \
  -d '{
    "model": "kira-3.0-video",
    "prompt": "Drone shot flying over a futuristic cyberpunk city with neon waterfalls at sunset",
    "aspect_ratio": "16:9",
    "duration_seconds": 6
  }'

{
  "id": "7821992019481726000",
  "status": "processing",
  "created": 1726000000,
  "model": "kira-3.0-video"
}

curl -X GET https://kiraai.vn/api/v1/videos/operations/7821992019481726000 \
  -H "Authorization: Bearer YOUR_KIRA_API_KEY"

{
  "id": "7821992019481726000",
  "status": "completed",
  "done": true,
  "data": [
    {
      "b64_json": "AAAAIGZ0eXBpc29t... [chuỗi Base64 video MP4]",
      "mime_type": "video/mp4"
    }
  ]
}

import fs from "fs";

const API_KEY = "YOUR_KIRA_API_KEY";
const BASE_URL = "https://kiraai.vn/api/v1";

// 1. Khởi tạo tác vụ tạo video
console.log("🎬 Đang gửi yêu cầu tạo video...");
const initRes = await fetch(`${BASE_URL}/videos/generations`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    model: "kira-3.0-video",
    prompt: "Drone shot flying over a futuristic cyberpunk city with neon waterfalls at sunset",
    aspect_ratio: "16:9",
    duration_seconds: 6
  })
});

const initData = await initRes.json();
const operationId = initData.id;
console.log(`⏳ Đã nhận Operation ID: ${operationId}, đang tiến hành dựng video...`);

// 2. Định kỳ kiểm tra trạng thái mỗi 10 giây
while (true) {
  await new Promise(resolve => setTimeout(resolve, 10000));
  const checkRes = await fetch(`${BASE_URL}/videos/operations/${operationId}`, {
    headers: { "Authorization": `Bearer ${API_KEY}` }
  });
  const statusData = await checkRes.json();

  if (statusData.done) {
    if (statusData.error) {
      throw new Error(`Lỗi tạo video: ${statusData.error}`);
    }
    const videoBuffer = Buffer.from(statusData.data[0].b64_json, "base64");
    fs.writeFileSync("output.mp4", videoBuffer);
    console.log("✅ Video đã hoàn thành! Đã lưu tệp output.mp4");
    break;
  } else {
    console.log("⏳ AI đang xử lý khung hình, vui lòng chờ...");
  }
}

import requests
import base64
import time

API_KEY = "YOUR_KIRA_API_KEY"
BASE_URL = "https://kiraai.vn/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# 1. Gửi yêu cầu khởi tạo video
print("🎬 Đang gửi yêu cầu tạo video...")
init_res = requests.post(
    f"{BASE_URL}/videos/generations",
    headers=headers,
    json={
        "model": "kira-3.0-video",
        "prompt": "Drone shot flying over a futuristic cyberpunk city with neon waterfalls at sunset",
        "aspect_ratio": "16:9",
        "duration_seconds": 6
    }
)

init_data = init_res.json()
operation_id = init_data.get("id")
print(f"⏳ Đã nhận Operation ID: {operation_id}. Đang tiến hành dựng video...")

# 2. Định kỳ kiểm tra trạng thái mỗi 10 giây
while True:
    time.sleep(10)
    poll_res = requests.get(f"{BASE_URL}/videos/operations/{operation_id}", headers=headers)
    status_data = poll_res.json()

    if status_data.get("done"):
        if status_data.get("error"):
            print(f"❌ Lỗi tạo video: {status_data.get('error')}")
            break
        video_bytes = base64.b64decode(status_data["data"][0]["b64_json"])
        with open("output.mp4", "wb") as f:
            f.write(video_bytes)
        print("✅ Video đã dựng xong! Đã lưu tệp output.mp4")
        break
    else:
        print("⏳ AI đang xử lý khung hình, vui lòng chờ thêm giây lát...")

# Khai báo nhà cung cấp mặc định (viết thường toàn bộ: "kiraai")
model_provider = "kiraai"
model = "gpt-5.6-sol" # Khuyên dùng: gpt-5.6-sol, gpt-5.6-luna hoặc gpt-oss-120b
model_reasoning_effort = "medium"
approval_policy = "never"

# Định nghĩa provider Kira AI kết nối qua Responses API
[model_providers.kiraai]
name = "kiraai"
base_url = "https://kiraai.vn/api/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

# Cấp quyền tin cậy cho thư mục dự án (để Codex tự động tạo file và chạy lệnh shell)
[projects."/duong/dan/den/thu/muc/du/an"]
trust_level = "trusted"

# Thêm biến môi trường vào ~/.zshrc (hoặc ~/.bashrc)
echo 'export OPENAI_API_KEY="kira_api_key_cua_ban"' >> ~/.zshrc
source ~/.zshrc

// Mở tệp ~/.codex/auth.json và dán nội dung:
{
  "OPENAI_API_KEY": "kira_api_key_cua_ban"
}

curl -X GET https://kiraai.vn/api/v1/user/profile \
  -H "Authorization: Bearer YOUR_API_KEY_HOAC_JWT"

const res = await fetch('https://kiraai.vn/api/v1/user/usage/logs?page=1&limit=20', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const data = await res.json();
console.log(data.logs); // Mảng chi tiết: timestamp, model, prompt_tokens, completion_tokens, tokens_used, cost_vnd...

curl -X POST https://kiraai.vn/api/v1/user/keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "App Mobile Key"}'

curl -X GET https://kiraai.vn/api/v1/models \
  -H "Authorization: Bearer YOUR_KIRA_API_KEY"

curl -X GET https://kiraai.vn/api/v1/audio/voices