Tích hợp API tạo ảnh AI vào website trong 10 phút (ví dụ JavaScript/Node.js)

✍️ Ngô Thuần (Copax)📅 29/10/2026👁 168⏱ 5 phút đọc
Tích hợp API tạo ảnh AI vào website trong 10 phút (ví dụ JavaScript/Node.js)

Bạn muốn website của mình có tính năng "nhập mô tả – nhận ảnh AI"? Với một API tạo ảnh, bạn không cần tự vận hành GPU, cài model hay quản lý hàng đợi. Bài viết này hướng dẫn tích hợp API tạo ảnh của Lumina – nền tảng tạo ảnh và video AI tại lumina.aiappviet.com – vào website bằng JavaScript/Node.js theo cách an toàn, gọn và dễ mở rộng.

Nguồn: endpoint và tham số trong bài lấy từ trang Khoá API của Lumina (tài liệu gọi API hiển thị sau khi đăng nhập). Nếu Lumina cập nhật API, hãy ưu tiên tài liệu trên trang đó.

Thông tin nhanh về API Lumina

  • Base URL: https://lumina.aiappviet.com
  • Xác thực: header Authorization: Bearer <khoá API> (khoá có dạng lm_...).
  • Tạo ảnh: POST /api/v1/images
  • Tạo video: POST /api/v1/videos
  • Lấy kết quả tác vụ: GET /api/v1/generations/{id}
  • Tính phí: Liên hệ để được giá tốt nhất.
  • Lưu trữ: ảnh và video trong thư viện Lumina chỉ giữ 24 giờ – hãy tải về nếu cần lưu lâu.

Bước 1: Lấy khoá API

  1. Truy cập lumina.aiappviet.com, đăng ký/đăng nhập tài khoản.
  2. Mua gói điểm phù hợp.
  3. Vào mục Khoá API để xem và sao chép khoá của bạn.
  4. Lưu khoá vào biến môi trường, không đưa vào mã nguồn hay commit lên Git:
# file .env (thêm .env vào .gitignore)
LUMINA_API_URL=https://lumina.aiappviet.com
LUMINA_API_KEY=lm_xxxxxxxx

Kiến trúc tổng quan

Sai lầm phổ biến nhất là gọi API trực tiếp từ trình duyệt kèm khoá. Ai mở DevTools cũng lấy được khoá và dùng hết điểm của bạn. Kiến trúc đúng:

  1. Frontend (trình duyệt): form nhập prompt, gửi tới backend của bạn và hiển thị ảnh.
  2. Backend của bạn (Node.js): giữ khoá bí mật, kiểm tra đầu vào, giới hạn số lượt, rồi gọi Lumina.
  3. Lumina API: tạo ảnh và trả về URL kết quả.

Bước 2: Thử nhanh bằng cURL

curl -X POST https://lumina.aiappviet.com/api/v1/images \
  -H "Authorization: Bearer lm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "chân dung, ánh sáng cửa sổ",
    "size": "1:1"
  }'

Các tham số chính:

  • prompt – mô tả ảnh.
  • size – tỉ lệ khung hình, ví dụ "1:1", "16:9".
  • image – (tuỳ chọn) URL một ảnh tham chiếu.
  • images – (tuỳ chọn) mảng URL nhiều ảnh tham chiếu, ví dụ ảnh sản phẩm cần giữ đúng form.

Bước 3: Hiểu phản hồi và tác vụ bất đồng bộ

Kết quả có dạng:

{
  "id": 12,
  "status": "done",
  "url": "https://.../ket-qua.png",
  "error": null,
  "creditsCharged": 2
}
  • status là running, done hoặc failed.
  • url có giá trị khi done; error có nội dung khi failed.
  • creditsCharged là số điểm đã trừ (lượt lỗi trả 0). (Con số trong ví dụ chỉ minh hoạ.)

Nếu status là running, hãy gọi GET /api/v1/generations/{id} để lấy kết quả khi hoàn tất.

Mã lỗi: 401 khoá sai · 402 không đủ điểm còn hiệu lực · 429 vượt số lần hoặc đang chạy đủ số tác vụ · 400 nội dung không hợp lệ.

Bước 4: Backend proxy bằng Express

// server.js
import express from 'express';
import 'dotenv/config';

const app = express();
app.use(express.json());
app.use(express.static('public'));

const BASE = process.env.LUMINA_API_URL;
const headers = {
  Authorization: `Bearer ${process.env.LUMINA_API_KEY}`,
  'Content-Type': 'application/json'
};
const sleep = (ms) => new Promise(r => setTimeout(r, ms));

async function waitForGeneration(id, timeoutMs = 120000) {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const job = await fetch(`${BASE}/api/v1/generations/${id}`, { headers }).then(r => r.json());
    if (job.status !== 'running') return job;
    await sleep(2000);
  }
  throw new Error('Quá thời gian chờ');
}

app.post('/api/generate', async (req, res) => {
  const prompt = String(req.body.prompt || '').trim();
  if (!prompt || prompt.length > 1000) {
    return res.status(400).json({ error: 'Prompt không hợp lệ' });
  }
  try {
    const r = await fetch(`${BASE}/api/v1/images`, {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, size: '1:1' })
    });
    let job = await r.json();
    if (!r.ok) return res.status(r.status).json({ error: job.error || 'Lỗi API' });
    if (job.status === 'running') job = await waitForGeneration(job.id);
    if (job.status === 'failed') return res.status(500).json({ error: job.error });
    res.json({ url: job.url });
  } catch (e) {
    res.status(502).json({ error: 'Không kết nối được dịch vụ tạo ảnh' });
  }
});

app.listen(3000, () => console.log('http://localhost:3000'));

Cài và chạy:

npm init -y
npm install express dotenv
# thêm "type": "module" vào package.json
node server.js

Bước 5: Giao diện phía trình duyệt

Tạo file public/index.html:

<form id="f">
  <textarea id="prompt" rows="3" placeholder="Mô tả bức ảnh bạn muốn..."></textarea>
  <button>Tạo ảnh</button>
</form>
<p id="status"></p>
<img id="result" alt="" style="max-width:100%">

<script>
const f = document.getElementById('f');
const statusEl = document.getElementById('status');
const img = document.getElementById('result');

f.addEventListener('submit', async (e) => {
  e.preventDefault();
  const btn = f.querySelector('button');
  btn.disabled = true;
  statusEl.textContent = 'Đang tạo ảnh...';
  try {
    const r = await fetch('/api/generate', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ prompt: document.getElementById('prompt').value })
    });
    const data = await r.json();
    if (!r.ok) throw new Error(data.error);
    img.src = data.url;
    statusEl.textContent = 'Hoàn tất!';
  } catch (err) {
    statusEl.textContent = 'Lỗi: ' + err.message;
  } finally {
    btn.disabled = false;
  }
});
</script>

Mở http://localhost:3000, nhập prompt và bấm Tạo ảnh – website của bạn đã có tính năng tạo ảnh AI.

Mở rộng: tạo video với cùng khoá

Cùng khoá API, bạn có thể tạo video bằng POST /api/v1/videos:

curl -X POST https://lumina.aiappviet.com/api/v1/videos \
  -H "Authorization: Bearer lm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "người mẫu quay chậm, gió nhẹ",
    "size": "16:9",
    "duration": 5,
    "image": "https://example.com/khung-dau.jpg"
  }'

image là ảnh khung đầu (tuỳ chọn). Video thường mất thời gian hơn, nên luôn kiểm tra kết quả qua GET /api/v1/generations/{id}. Xem thêm API tạo video AI.

Trước khi chạy thật

  1. Giới hạn tần suất: chặn spam theo IP/tài khoản (ví dụ express-rate-limit) – đồng thời tránh lỗi 429 từ Lumina.
  2. Xử lý lỗi 402: hiển thị thông báo thân thiện khi hết điểm và theo dõi số dư.
  3. Lưu ảnh về hệ thống của bạn: kết quả trên Lumina chỉ giữ 24 giờ.
  4. Kiểm duyệt nội dung: lọc prompt vi phạm và tuân thủ điều khoản dịch vụ.
  5. Ghi log: lưu prompt, thời gian xử lý, creditsCharged để tối ưu chi phí.

Kết luận

Tích hợp API tạo ảnh vào website không phức tạp nếu bạn giữ khoá API ở backend và xử lý đúng trạng thái running/done/failed. Bắt đầu bằng cách tạo tài khoản và lấy khoá tại lumina.aiappviet.com. Nếu bạn muốn biến bản thử nghiệm thành sản phẩm chạy thật (người dùng, credit, thanh toán, triển khai), xem dịch vụ biến app AI thành sản phẩm hoặc liên hệ với SDG.

Ngô Thuần (Copax)

Train model AI tạo ảnh, dựng hạ tầng API và biến ý tưởng AI thành phần mềm chạy thật.

Xem giới thiệu →

Bài liên quan