Khái niệm cốt lõi

Runs

Một run là một yêu cầu tạo sinh đơn lẻ. Khi bạn gọi API, Runbase tạo một run, gửi nó đến mô hình AI bên dưới, và trả về kết quả khi đã sẵn sàng.

Mỗi run đều trải qua một vòng đời:

POST /api/v1/runs → pending → processing → succeeded (or failed)

Trạng thái run

Bất đồng bộ theo thiết kế

Toàn bộ quá trình tạo sinh đều là bất đồng bộ. Khi bạn tạo một run, API trả về ngay với status: "pending" và một run ID. Sau đó bạn thăm dò GET /api/v1/runs/:id cho đến khi trạng thái là succeeded hoặc failed.

Thời gian hoàn tất thay đổi tùy theo model, tải của nhà cung cấp và độ phức tạp của đầu vào:

• Các model hình ảnh thường hoàn tất nhanh hơn các model video
• Các model video phụ thuộc nhiều vào thời lượng, độ phân giải, và thời gian chờ hàng đợi của nhà cung cấp

Chi phí và hoàn tiền

Chi phí được trừ từ balance của bạn khi run được tạo, không phải khi nó hoàn tất. Điều này giữ trước số tiền.

Nếu run thất bại, toàn bộ chi phí sẽ được tự động hoàn lại vào balance của bạn. Bạn không bao giờ phải trả tiền cho các lần tạo sinh thất bại.

Models

Runbase là một cổng trung gian thống nhất đến các model từ nhiều nhà cung cấp. Mỗi model có một ID duy nhất theo định dạng provider/model-name (ví dụ: openai/gpt-image-2, bytedance/seedance-2).

Tất cả các model dùng chung API hai endpoint:

1. POST /api/v1/runs — tạo một run với model ID và input
2. GET /api/v1/runs/:id — kiểm tra trạng thái và lấy kết quả

Schema input thay đổi theo từng model (các tham số khác nhau cho prompt, kích thước, chất lượng, image_urls, v.v.), nhưng phần bao bọc request/response luôn giống nhau.

Xác thực

Mỗi request API đều yêu cầu một API key trong header Authorization dưới dạng Bearer token. Key bắt đầu bằng sk- và có thể được tạo trong dashboard. Xem Authentication để biết chi tiết.

Balance

Runbase sử dụng balance trả trước. Bạn nạp thêm balance, và mỗi run sẽ trừ từ số đó dựa trên giá của model. Xem Billing để biết chi tiết.