Sử dụng SeedRouter từ tác tử AI

Tác tử có thể sử dụng SeedRouter theo ba cách. Cả ba dùng chung khóa API, số dư, mô hình và giới hạn, đồng thời được tính phí như nhau.

Để chạy chính tác tử trên các mô hình văn bản của SeedRouter, hãy xem Tác tử lập trình trên SeedRouter.

Thiết lập khóa một lần

Tạo khóa trên trang Khóa API rồi export khóa để tác tử có thể đọc mà không đưa khóa vào các tệp dự án:

export SEEDROUTER_API_KEY=YOUR_API_KEY

Trang Khóa API cũng có nút Kết nối qua MCP để hiển thị cấu hình sẵn dùng cho từng client MCP.

Tác tử làm gì trên SeedRouter

1. Tìm mô hình: dùng list_models qua MCP hoặc danh sách mô hình trong /llms.txt. Mỗi mô hình có trang giới thiệu đều có bản tóm tắt dạng văn bản thuần tại https://seedrouter.ai/models/<slug>/llms.txt, gồm tham số, giá và ví dụ.
2. Đọc lược đồ đầu vào: dùng get_model_schema qua MCP hoặc trang tài liệu của mô hình.
3. Dùng URL đa phương tiện công khai: các endpoint tạo nội dung chỉ nhận ảnh, video và âm thanh tham chiếu dưới dạng URL http(s) công khai. Dữ liệu đầu vào dạng Base64 bị từ chối, vì vậy trước tiên hãy lưu trữ các tệp cục bộ ở nơi có thể truy cập được.
4. Kiểm tra giá: get_pricing qua MCP trả về biểu phí hiện tại của mô hình bằng USD trước khi gửi bất kỳ tác vụ nào.
5. Gửi và chờ: gọi submit_task, sau đó gọi get_task với wait_seconds: 50 cho đến khi tác vụ hoàn tất. Qua HTTP, hãy gửi đến endpoint của mô hình rồi truy vấn GET /v1/tasks/{id} khoảng ba giây một lần.

Tác vụ thất bại không bị tính phí. Việc gửi tác vụ không có tính lũy đẳng: gửi lại yêu cầu mà bạn chưa nhận được phản hồi sẽ tạo tác vụ thứ hai và trừ thêm tiền từ số dư, vì vậy hãy kiểm tra lịch sử tác vụ hoặc số dư trước.

Các giới hạn cần tính đến

Yêu cầu cũng có thể bị giới hạn tần suất, khi đó cũng trả về HTTP 429. Khi gặp HTTP 429, hãy chờ theo Retry-After nếu header này có mặt; nếu không, tăng thời gian chờ theo cấp số nhân, thêm dao động ngẫu nhiên và giới hạn thời gian chờ tối đa. Hãy quyết định dựa trên mã trạng thái thay vì phân tích phần thân lỗi, vì các endpoint văn bản trả lỗi theo định dạng của giao thức tương ứng. Với xử lý hàng loạt, hãy duy trì hàng đợi và gửi tác vụ mới khi các tác vụ đang chạy hoàn tất, thay vì gửi tất cả cùng lúc. Liên hệ [email protected] nếu bạn cần giới hạn cao hơn.

Các điểm truy cập ở dạng máy đọc được