การกำหนดค่า Replicate / fal.ai
Replicate และ fal.ai มีลักษณะเป็น 'แพลตฟอร์ม Model API' มากกว่า ทั้งสองสามารถเรียกใช้งานโมเดลสำหรับรูปภาพ เสียง วิดีโอ ฯลฯ ได้ แต่ไม่ใช่ทุกโมเดลจะใช้ชุดพารามิเตอร์เดียวกัน ผู้เริ่มต้นจำเป็นต้องเลือกโมเดลที่ต้องการก่อน แล้วจึงดูช่องข้อมูลอินพุตที่ระบุไว้ในหน้าของโมเดลนั้นๆ
ข้อมูลทางการ การดาวน์โหลดและเอกสารประกอบให้อิงตามเว็บไซต์ทางการ
ความแตกต่างจากผู้ให้บริการ AI ทั่วไป
| แพลตฟอร์ม | สิ่งที่ต้องเตรียมก่อน | ข้อควรระวัง |
|---|---|---|
| Replicate | API Token, หน้าโมเดล, พารามิเตอร์อินพุต | Node SDK ทางการมักจะอ่าน Token จาก REPLICATE_API_TOKEN โดยฟิลด์อินพุตจะแตกต่างกันไปตามแต่ละโมเดล |
| fal.ai | FAL_KEY, Model ID, พารามิเตอร์อินพุต | JS client ทางการมักจะอ่าน Key จาก FAL_KEY และคุณยังต้องตรวจสอบฟิลด์ในหน้าโมเดลที่ต้องการด้วย |
| ผู้ให้บริการ AI แชททั่วไป | Key, Base URL, ชื่อโมเดล | เน้นการแชทด้วยข้อความ/มัลติโมดอลเป็นหลัก ไม่ได้หมายความว่าจะรองรับโมเดลรูปภาพและวิดีโอทั้งหมด |
ทำความเข้าใจหน้าของโมเดลนั้นๆ ก่อน
| ฟิลด์บนหน้าเว็บ | ความหมาย | วิธีกรอก |
|---|---|---|
| Model ID / Version | ต้องการเรียกใช้โมเดลใด | Replicate มักจะใช้รูปแบบ owner/model หรือ owner/model: version ตามที่ระบุในหน้าโมเดล ส่วน fal.ai ให้กรอกตาม Model ID ในหน้าโมเดล |
| Input schema | โมเดลนี้ต้องการฟิลด์อินพุตอะไรบ้าง | กรอกแต่ละรายการตามหน้าโมเดล อย่าคัดลอกฟิลด์จากโมเดลอื่น |
| Output | ผลลัพธ์ที่ส่งกลับมามีหน้าตาอย่างไร | อาจเป็น URL รูปภาพ, URL วิดีโอ, Array หรือ Task object หลังจากการเรียกใช้ คุณจำเป็นต้องดึงผลลัพธ์ตามโครงสร้างที่ส่งกลับมา |
| Example code | ตัวอย่างโค้ดเรียกใช้งานอย่างเป็นทางการที่สร้างขึ้นสำหรับโมเดลปัจจุบัน | แนะนำให้คัดลอกตัวอย่างจากหน้าโมเดลก่อน แล้วค่อยแทนที่ด้วย Key และเนื้อหาอินพุตของคุณเอง |
ตัวอย่างคำขอ (Request example)
อย่าเขียนโค้ดของทั้งสองแพลตฟอร์มนี้ปนกัน ให้เลือกแท็บของแพลตฟอร์มที่คุณใช้งาน และแทนที่เฉพาะ Key, Model ID และฟิลด์อินพุตของคุณเอง
ตัวอย่าง Replicate สำหรับสร้างงาน 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);ตัวอย่าง 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);วิธีตรวจสอบความถูกต้องของฟิลด์
สิ่งที่สำคัญที่สุดในแพลตฟอร์มประเภทนี้คือ "หน้าของแต่ละโมเดล" อย่าเพียงแค่คัดลอก Key ของแพลตฟอร์มมาเท่านั้น แต่ต้องกรอกฟิลด์อินพุตให้ตรงตามหน้าโมเดลด้วย
| ข้อผิดพลาดหรือปัญหาที่พบ | สาเหตุที่พบบ่อย | วิธีแก้ไข |
|---|---|---|
| Model not found | Model ID, หมายเลขเวอร์ชัน หรือ Namespace ไม่ถูกต้อง | คัดลอกชื่อเรียกแบบเต็มจากหน้าโมเดล |
| Input field error | ชื่อฟิลด์, ประเภทข้อมูล หรือฟิลด์ที่จำเป็นไม่ตรงตามข้อกำหนดของโมเดลปัจจุบัน | ตรวจสอบ Input schema ในหน้าโมเดลและเพิ่มรายการที่ขาดหายไป |
| Returned result is empty | งานอาจยังไม่เสร็จสิ้น หรือฟิลด์ผลลัพธ์ไม่ได้อยู่ในตำแหน่งที่คุณกำลังอ่านค่า | ให้พิมพ์ (print) ผลลัพธ์ทั้งหมดที่ส่งกลับมาก่อน จากนั้นจึงดึง URL หรือไฟล์ตามโครงสร้าง Output |