Cấu hình Replicate / fal.ai
Replicate và fal.ai thiên về dạng 'nền tảng API mô hình'. Chúng có thể gọi các mô hình hình ảnh, âm thanh, video, v.v., nhưng không phải mọi mô hình đều dùng chung một bộ tham số. Người mới bắt đầu trước tiên cần chọn một mô hình cụ thể, sau đó xem các trường đầu vào được cung cấp trên trang của mô hình đó.
Thông tin chính thức Tài liệu và tải xuống vui lòng tham khảo trang web chính thức.
Điểm khác biệt so với nhà cung cấp AI thông thường
| Nền tảng | Những gì bạn cần chuẩn bị trước | Lưu ý |
|---|---|---|
| Replicate | API Token, Trang mô hình, Tham số đầu vào | Node SDK chính thức thường đọc Token từ REPLICATE_API_TOKEN; các trường đầu vào sẽ khác nhau tùy theo từng mô hình. |
| fal.ai | FAL_KEY, Model ID, Tham số đầu vào | JS client chính thức thường đọc Key từ FAL_KEY; bạn cũng cần kiểm tra các trường trên trang mô hình cụ thể. |
| Nhà cung cấp Chat AI thông thường | Key, Base URL, Tên mô hình | Chủ yếu phục vụ trò chuyện văn bản/đa phương thức, không đồng nghĩa với việc hỗ trợ tất cả các mô hình hình ảnh và video |
Tìm hiểu trang của mô hình cụ thể trước
| Trường trên trang | Ý nghĩa | Cách điền |
|---|---|---|
| Model ID / Version | Mô hình cụ thể nào sẽ được gọi | Replicate thường dùng định dạng owner/model hoặc owner/model: version được cung cấp trên trang mô hình; fal.ai điền theo ID trên trang mô hình |
| Input schema | Mô hình này yêu cầu những trường đầu vào nào | Điền từng mục theo trang mô hình, không sao chép trường từ mô hình khác. |
| Output | Kết quả trả về trông như thế nào? | Có thể là URL hình ảnh, URL video, mảng hoặc đối tượng tác vụ. Sau khi gọi, bạn cần trích xuất kết quả theo cấu trúc trả về. |
| Example code | Ví dụ gọi API chính thức được tạo cho mô hình hiện tại | Nên sao chép ví dụ hiện tại từ trang mô hình trước, sau đó thay thế bằng Key và nội dung đầu vào của riêng bạn. |
Ví dụ yêu cầu
Không kết hợp cách viết của hai nền tảng dưới đây. Hãy dùng tab tương ứng với nền tảng bạn sử dụng và chỉ thay thế Key, model ID cũng như các trường đầu vào của bạn.
Ví dụ tạo tác vụ dự đoán trên Replicate
import Replicate from "replicate"; const replicate = new Replicate({ auth: process.env.REPLICATE_API_TOKEN }); const output = await replicate.run("owner/model:version from the model page", { input: { prompt: "A clean product showcase video", duration: 5 } }); console.log(output);Ví dụ gọi mô hình trên fal.ai
import { fal } from "@fal-ai/client"; fal.config({ credentials: process.env.FAL_KEY }); const result = await fal.subscribe("MODEL_ID_FROM_THE_MODEL_PAGE", { input: { prompt: "A photorealistic product poster", image_size: "square_hd" }, logs: true }); console.log(result.data);Cách kiểm tra và xác thực các trường
Điều quan trọng nhất trên các nền tảng này là "trang mô hình cụ thể". Đừng chỉ sao chép Key của nền tảng; hãy điền các trường đầu vào theo đúng trang mô hình.
| Lỗi hoặc hiện tượng | Nguyên nhân phổ biến | Giải pháp |
|---|---|---|
| Model not found | Model ID, số phiên bản hoặc namespace không chính xác | Sao chép đầy đủ tên gọi từ trang mô hình |
| Input field error | Tên trường, kiểu dữ liệu hoặc mục bắt buộc không đáp ứng yêu cầu của mô hình hiện tại | Kiểm tra input schema trên trang mô hình và bổ sung các mục còn thiếu |
| Returned result is empty | Tác vụ có thể chưa hoàn thành, hoặc trường output không nằm ở vị trí bạn đang đọc | Trước tiên hãy in toàn bộ kết quả trả về, sau đó trích xuất URL hoặc tệp theo cấu trúc output |