Quickstart · chạy trong 5 phút

Bốn bước: lấy key → gửi task → nhận kết quả → lặp lại. Ví dụ dưới dùng gói 720p Tiêu chuẩn ($0.61/clip) — đây là gói nên bắt đầu.

1. Lấy API key

Mở bàn điều khiển — tài khoản tự tạo, tặng ngay lượt dùng thử. Trong môi trường hiện tại, API key chính là ID tài khoản của bạn.

2. Gửi task đầu tiên

curl -X POST https://coursequill.com/api/tram-job \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "YOUR_API_KEY",
    "type": "video",
    "tier": "p720",
    "seconds": 5,
    "prompt": "Video quảng cáo cà phê sáng, phong cách Sài Gòn"
  }'

import requests

r = requests.post("https://coursequill.com/api/tram-job", json={
    "uid": "YOUR_API_KEY",
    "type": "video",
    "tier": "p720",
    "seconds": 5,
    "prompt": "Video quảng cáo cà phê sáng, phong cách Sài Gòn"
})
print(r.json())  # {"ok": true, "jobId": "...", "cost": 122, "balance": ...}

const r = await fetch("https://coursequill.com/api/tram-job", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    uid: "YOUR_API_KEY",
    type: "video",
    tier: "p720",
    seconds: 5,
    prompt: "Video quảng cáo cà phê sáng, phong cách Sài Gòn"
  })
});
console.log(await r.json());

3. Kiểm tra kết quả

curl "https://coursequill.com/api/tram-job?id=YOUR_API_KEY"

Trước khi submit, bạn có thể kiểm tra chi phí chính xác qua /api/quote — dùng cùng một bộ tính giá với lúc trừ tiền:

curl "https://coursequill.com/api/quote?type=video&tier=p720&seconds=10"
# {"ok":true,"units":2,"credits":244,"usd":1.22,"vnd":31110}

Xác thực

Giai đoạn hiện tại dùng uid (ID tài khoản) làm khóa. Giữ bí mật — ai có uid đều dùng được ví của bạn. Không đặt uid trong code chạy trên trình duyệt của người dùng cuối.

• Tạo tài khoản: mở bàn điều khiển, uid tự sinh và lưu tại trình duyệt của bạn.
• Đổi uid: xóa dữ liệu trình duyệt sẽ mất quyền truy cập ví — hãy lưu uid lại.
• Khách doanh nghiệp: liên hệ để cấp key riêng có giới hạn và webhook.

Gửi tác vụ

POST /api/tram-job với JSON:

Phản hồi thành công: {"ok":true,"jobId","balance","cost","units","status"}. Nếu tất cả nguồn lỗi: status:"failed" và credit tự hoàn (refunded:true).

Webhook (sắp ra mắt)

Hiện tại kết quả trả đồng bộ trong phản hồi. Webhook cho task dài (event job.succeeded / job.failed) đang hoàn thiện — khách cam kết tháng sẽ được ưu tiên kích hoạt. Để lại lời nhắn để đăng ký trước.

Chọn độ phân giải

Mẹo: không chắc thì cứ p720. Muốn rẻ hơn khi thử prompt thì p480, hài lòng rồi mới render p720 trở lên.

Tiếng Việt & nhãn nội dung AI

Video thoại tiếng Việt dùng tier lipsync — giọng bản địa, khớp khẩu hình theo âm thanh. Mọi nội dung đầu ra đều mang nhãn máy đọc được, tuân thủ Nghị định 142/2026 về nhận diện nội dung do AI tạo. Bạn có thể dùng trực tiếp trong chiến dịch mà không cần xử lý thêm.

Mã lỗi

Giới hạn

• Thờoi lượng tối đa mỗi clip: 300 giây (60 gói 5 giây).
• Prompt tối đa 2.000 ký tự.
• Đồng thờoi: tài khoản thử 1 task/lần; khách nạp ≥ $500 được nâng; cam kết tháng có kênh riêng.
• Giới hạn tốc độ: liên hệ nếu cần burst lớn (ra mắt sản phẩm, chiến dịch).