Mô hình - Runbase Docs

Runbase cung cấp quyền truy cập vào các mô hình tạo ảnh và video hàng đầu từ nhiều nhà cung cấp thông qua một API duy nhất.

Duyệt các mô hình

Truy cập Trang Models để xem tất cả các mô hình khả dụng cùng với giá, khả năng và ví dụ đầu ra. Mỗi mô hình có một trang chi tiết riêng với:

Playground — kiểm tra mô hình trong trình duyệt của bạn trước khi viết bất kỳ mã nào
Pricing — chi phí theo mỗi lần chạy hoặc theo giây
Examples — đầu ra mẫu kèm prompt
API reference — các tham số đầu vào riêng cho mô hình và các mẫu mã

Playground

Mỗi trang mô hình đều bao gồm một Playground tương tác ở phía trên. Đăng nhập, nhập prompt, và nhấp Run model để xem kết quả trong vài giây. Đây là cách nhanh nhất để đánh giá chất lượng và tốc độ của một mô hình trước khi tích hợp vào ứng dụng của bạn.

Định dạng Model ID

Mỗi mô hình có một ID theo định dạng provider/model-name, ví dụ:

openai/gpt-image-2 — tạo ảnh
bytedance/seedance-2 — tạo video
google/veo-3 — tạo video

Danh sách đầy đủ các mô hình khả dụng và ID của chúng nằm trên Trang Models. Các mô hình được bổ sung thường xuyên — hãy kiểm tra ở đó để xem mới nhất.

Tham số đầu vào

Mỗi mô hình định nghĩa lược đồ đầu vào riêng. Các tham số phổ biến bao gồm:

prompt (string) — mô tả văn bản về nội dung cần tạo
aspect_ratio (string) — kích thước đầu ra, ví dụ "1:1", "16:9"
quality (string) — cấp chất lượng tạo
image_urls (string[]) — URLs của ảnh tham chiếu (nếu được hỗ trợ)

Xem trang chi tiết của từng mô hình để biết lược đồ đầu vào đầy đủ và các tùy chọn khả dụng.

Sử dụng một mô hình

Truyền model ID và đối tượng input vào endpoint create run:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

Nếu bạn truyền một model ID không hợp lệ, bạn sẽ nhận được lỗi 400 model_not_found. Nếu input không khớp với lược đồ của mô hình, bạn sẽ nhận được 400 invalid_input kèm mô tả về vấn đề.

Mô hình ảnh so với video

Mô hình ảnh trả về một hoặc nhiều URL ảnh trong output.urls. Thời gian tạo khác nhau tùy theo mô hình, tải của nhà cung cấp và độ phức tạp của input.
Mô hình video trả về một URL video trong output.urls. Thời gian tạo khác nhau tùy theo mô hình, thời lượng, độ phân giải và tải của nhà cung cấp.

Hình dạng API là giống nhau cho cả hai — điểm khác duy nhất là các URL đầu ra trỏ tới đâu.