Tài liệu API

https://nov.ai.vn/api

curl https://nov.ai.vn/api/auth/me \
  -H "X-API-Key: cmsnt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "key": "tmc.image-to-video",
  "name": "...",
  "category": "video",
  "output": "video",            // image | video | audio | text
  "pricing": { "mode": "fixed", "base": 100, "perUnit": 0, "unitLabel": null, "min": 0 },
  "fields": [
    { "name": "prompt", "label": "Mô tả", "type": "textarea", "required": true, "max": 2000 },
    { "name": "ratio", "label": "Tỉ lệ", "type": "select", "default": "16:9",
      "options": [{ "value": "16:9", "label": "Ngang" }, { "value": "9:16", "label": "Dọc" }] },
    { "name": "image", "label": "Ảnh mẫu", "type": "image", "accept": "image/*" }
  ]
}

curl -X POST https://nov.ai.vn/api/account/ai/tools/tmc.image-to-video/quote \
  -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{ "input": { "prompt": "Một chú mèo phi hành gia" } }'

# => { "credits": 120 }

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

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

curl -X POST https://nov.ai.vn/api/account/ai/tools/tmc.image-to-video/run \
  -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{ "input": { "prompt": "Một chú mèo phi hành gia", "ratio": "16:9" } }'

# => {
#   "id": "3f1c...-uuid",
#   "code": "T8KQ2M4X",
#   "toolKey": "tmc.image-to-video",
#   "status": "PENDING",
#   "progress": 0,
#   "credits": 120,
#   "output": null,
#   ...
# }

{
  "id": "3f1c...-uuid",
  "code": "T8KQ2M4X",
  "status": "SUCCEEDED",
  "progress": 100,
  "credits": 120,
  "refunded": false,
  "error": null,
  "output": {
    "files": [{ "url": "https://nov.ai.vn/uploads/ai/outputs/....mp4", "type": "video", "name": "video.mp4" }],
    "text": "..."          // chỉ có với công cụ trả văn bản
  },
  "createdAt": "2026-10-29T08:00:00.000Z",
  "completedAt": "2026-10-29T08:01:12.000Z"
}

{
  "credits": 5400,            // credits hiện có
  "plan": { "name": "Pro", "expiresAt": "2026-11-29T00:00:00.000Z", "active": true, ... },
  "concurrency": 3,           // số tác vụ được chạy cùng lúc
  "totalUsed": 12600,
  ...
}

const BASE = "https://nov.ai.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) chạy công cụ
const task = await call("/account/ai/tools/tmc.image-to-video/run", {
  method: "POST",
  body: JSON.stringify({ input: { prompt: "Một chú mèo phi hành gia" } }),
});

// 2) hỏi trạng thái tới khi xong
let t = task;
while (["PENDING", "PROCESSING"].includes(t.status)) {
  await new Promise((r) => setTimeout(r, 5000));
  t = await call("/account/ai/tasks/" + task.id);
}
if (t.status !== "SUCCEEDED") throw new Error(t.error ?? t.status);
console.log(t.output.files.map((f) => f.url));

import os, time, requests

BASE = "https://nov.ai.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

task = call("POST", "/account/ai/tools/tmc.image-to-video/run",
            json={"input": {"prompt": "Một chú mèo phi hành gia"}})

t = task
while t["status"] in ("PENDING", "PROCESSING"):
    time.sleep(5)
    t = call("GET", f"/account/ai/tasks/{task['id']}")

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