Konfigurasi Replicate / fal.ai
Replicate dan fal.ai lebih mirip 'platform API model'. Keduanya dapat memanggil model untuk gambar, audio, video, dll., tetapi tidak semua model menggunakan kumpulan parameter yang sama. Pemula perlu memilih model tertentu terlebih dahulu lalu melihat bidang input yang disediakan di halaman model tersebut.
Informasi resmi Unduhan dan dokumentasi mengacu pada situs web resmi.
Perbedaannya dengan provider AI biasa
| Platform | Yang perlu disiapkan terlebih dahulu | Hal yang Perlu Diperhatikan |
|---|---|---|
| Replicate | API Token, Halaman Model, Parameter Input | Node SDK resmi biasanya membaca Token REPLICATE_API_TOKEN; bidang input berbeda untuk setiap model. |
| fal.ai | FAL_KEY, Model ID, Parameter Input | JS client resmi biasanya membaca Key FAL_KEY; Anda juga perlu memeriksa bidang di halaman model tertentu. |
| Provider AI Chat biasa | Key, Base URL, Nama Model | Utamanya untuk chat teks/multimodal, tidak berarti mendukung semua model gambar dan video |
Pahami halaman model spesifik terlebih dahulu
| Bidang Halaman | Arti | Cara Mengisi |
|---|---|---|
| Model ID / Version | Model spesifik mana yang dipanggil | Replicate umumnya menggunakan format owner/model atau owner/model: version yang tertera di halaman model; fal.ai diisi sesuai dengan ID di halaman model |
| Input schema | Bidang input apa saja yang dibutuhkan model ini | Isi setiap item sesuai dengan halaman model, jangan menyalin bidang dari model lain. |
| Output | Seperti apa hasil yang dikembalikan? | Bisa berupa URL gambar, URL video, array, atau objek tugas. Setelah pemanggilan, Anda perlu mengekstrak hasil sesuai format yang dikembalikan. |
| Example code | Contoh pemanggilan resmi yang dibuat untuk model saat ini | Sebaiknya salin contoh yang ada dari halaman model terlebih dahulu, lalu ganti dengan Key dan konten input Anda sendiri. |
Contoh request
Jangan mencampuradukkan penulisan untuk kedua platform berikut. Gunakan tab untuk platform yang Anda gunakan, dan cukup ganti Key, model ID, serta bidang input Anda sendiri.
Contoh Replicate untuk membuat tugas prediction
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);Contoh fal.ai untuk memanggil model
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);Cara memverifikasi bidang
Hal terpenting pada platform semacam ini adalah "halaman model spesifik". Jangan hanya menyalin Key platform; isi bidang input sesuai dengan halaman model.
| Kesalahan atau Masalah | Penyebab Umum | Solusi |
|---|---|---|
| Model not found | Model ID, nomor versi, atau namespace salah | Salin nama panggilan lengkap dari halaman model |
| Input field error | Nama bidang, tipe, atau item wajib tidak sesuai dengan persyaratan model saat ini | Periksa input schema di halaman model dan lengkapi item yang kurang |
| Hasil yang dikembalikan kosong | Tugas mungkin belum selesai, atau bidang output tidak berada di posisi yang Anda baca | Cetak terlebih dahulu seluruh hasil yang dikembalikan, lalu ekstrak URL atau file sesuai dengan struktur output |