Bắt đầu

Mọi request gửi và nhận JSON. Phản hồi luôn có trường ok; khi lỗi có thêm error mô tả bằng tiếng Việt.

Base URL

https://api.marketrix-global.com

Xác thực

Gửi API key ở header của mọi request. Chấp nhận cả hai kiểu — dùng kiểu nào tool của bạn hỗ trợ.

Credit

Credit bị trừ ngay khi tạo job. Nếu tạo thất bại vì lỗi hệ thống, credit được hoàn lại tự động. Xem bảng giá chi tiết từng model, hoặc gọi GET /api/v1/models để lấy bảng giá theo thời gian thực thay vì ghi cứng số trong code.

Tạo video

POST/api/v1/videos

Tham số

Ví dụ

curl -X POST https://api.marketrix-global.com/api/v1/videos \
  -H "X-API-Key: vk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Chú mèo phi hành gia trôi trong vũ trụ, ánh sáng rực rỡ",
    "duration": 10,
    "ratio": "9:16"
  }'

Phản hồi

{
  "ok": true,
  "video": {
    "id": "cms8rhkln0001vne0gfseyy7x",
    "status": "queued",
    "prompt": "Chú mèo phi hành gia...",
    "duration": 10,
    "ratio": "9:16",
    "credit_cost": 6,
    "video_url": null,
    "error": null,
    "created_at": "2026-07-31T09:50:14.411Z",
    "done_at": null
  },
  "balance": 458
}

Kiểm tra kết quả

GET/api/v1/videos/{id}

Hỏi lại mỗi 15–30 giây. Khi status là done thì video_url có link tải.

curl https://api.marketrix-global.com/api/v1/videos/cms8rhkln0001vne0gfseyy7x \
  -H "X-API-Key: vk_xxxxx"

Trạng thái

Ảnh tham chiếu

POST/api/v1/upload-image

Gửi multipart/form-data, field tên image. Nhận png/jpg/webp, tối đa 10MB. Bước này không tốn credit.

# 1) Tải ảnh lên
curl -X POST https://api.marketrix-global.com/api/v1/upload-image \
  -H "X-API-Key: vk_xxxxx" \
  -F "image=@nhan-vat.png"
# → { "ok": true, "image_url": "https://..." }

# 2) Tạo video từ ảnh đó
curl -X POST https://api.marketrix-global.com/api/v1/videos \
  -H "X-API-Key: vk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Nhân vật vẫy tay chào, camera zoom nhẹ","image_url":"https://..."}'

Các endpoint khác

Dùng key trong tool có sẵn

Nếu tool của bạn không cho điền API tuỳ ý mà chỉ hỗ trợ một số nhà cung cấp, hãy chọn nhà tương ứng bên dưới rồi đổi Base URL sang địa chỉ ở cột giữa. Key vẫn là key của bạn, credit vẫn trừ trong cùng một ví.

Lớp tương thích chỉ đổi hình dạng request. Giá, hạn mức và cách trừ credit hoàn toàn giống khi gọi /api/v1 trực tiếp.

Mã lỗi