Tài liệu API

https://bestai.io.vn/api

curl https://bestai.io.vn/api/v1/models \
  -H "X-API-Key: cmsnt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "id": "gemini-image",
  "object": "model",
  "name": "Gemini Image · 2K/4K, khuyên dùng",
  "type": "image",
  "output": "image",       // image | video | audio | text
  "pricing": { "mode": "fixed", "base": 1500, "per_unit": 0, "unit": null, "min": 0, "currency": "VND" },
  "params": [
    { "name": "prompt", "type": "string", "required": true, "description": "Mô tả", "max": 20000 },
    { "name": "aspect_ratio", "type": "enum", "required": false, "default": "1:1",
      "options": [{ "value": "1:1", "label": "1:1" }, { "value": "16:9", "label": "16:9" }] },
    { "name": "image_url", "type": "file_url", "file_type": "image", "required": false, "description": "Ảnh mẫu" }
  ]
}

curl -X POST https://bestai.io.vn/api/v1/generations \
  -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-image",
  "prompt": "Một chú mèo phi hành gia",
  "size": "1:1",
  "n": "1"
}'

{
  "id": "3f1c...-uuid",
  "object": "generation",
  "code": "T8KQ2M4X",
  "model": "gemini-image",
  "status": "succeeded",
  "progress": 100,
  "cost": 1500,                 // số tiền VND đã trừ
  "currency": "VND",
  "refunded": false,
  "output": {
    "type": "image",
    "files": [{ "url": "https://bestai.io.vn/uploads/ai/outputs/....png", "type": "image", "name": "image.png" }],
    "text": null                // chỉ có với model trả văn bản
  },
  "error": null,
  "created_at": "2026-10-30T08:00:00.000Z",
  "completed_at": "2026-10-30T08:00:41.000Z"
}

# => { "object": "estimate", "model": "gemini-image", "cost": 1500, "currency": "VND" }

curl -X POST https://bestai.io.vn/api/account/ai/uploads \
  -H "X-API-Key: $API_KEY" \
  -F "file=@./anh-mau.jpg"

# => { "url": "https://bestai.io.vn/uploads/ai/inputs/...", "name": "anh-mau.jpg", "mimeType": "image/jpeg", "size": 183204 }

{
  "credits": 54000,           // số dư ví hiện có (VND)
  "concurrency": 3,           // số tác vụ được chạy cùng lúc
  "totalUsed": 126000,       // tổng tiền đã dùng (VND)
  ...
}

const BASE = "https://bestai.io.vn/api";
const headers = { "X-API-Key": process.env.API_KEY, "Content-Type": "application/json" };

async function call(path, init = {}) {
  const res = await fetch(BASE + path, { ...init, headers });
  const body = await res.json();
  if (!res.ok) throw new Error(body.message);
  return body;
}

// 1) gửi input
let gen = await call("/v1/generations", {
  method: "POST",
  body: JSON.stringify({"model":"gemini-image","prompt":"Một chú mèo phi hành gia","size":"1:1","n":"1"}),
});

// 2) hỏi trạng thái tới khi xong
while (["queued", "processing"].includes(gen.status)) {
  await new Promise((r) => setTimeout(r, 5000));
  gen = await call("/v1/generations/" + gen.id);
}
if (gen.status !== "succeeded") throw new Error(gen.error ?? gen.status);
console.log(gen.output.files.map((f) => f.url));

import os, time, requests

BASE = "https://bestai.io.vn/api"
H = {"X-API-Key": os.environ["API_KEY"]}

def call(method, path, **kw):
    r = requests.request(method, BASE + path, headers=H, timeout=60, **kw)
    body = r.json()
    if not r.ok:
        raise RuntimeError(body.get("message"))
    return body

gen = call("POST", "/v1/generations", json={"model":"gemini-image","prompt":"Một chú mèo phi hành gia","size":"1:1","n":"1"})

while gen["status"] in ("queued", "processing"):
    time.sleep(5)
    gen = call("GET", f"/v1/generations/{gen['id']}")

if gen["status"] != "succeeded":
    raise RuntimeError(gen.get("error") or gen["status"])
print([f["url"] for f in gen["output"]["files"]])