Configuration Replicate / fal.ai
Replicate et fal.ai s'apparentent davantage à des « plateformes d'API de modèles ». Elles permettent d'appeler des modèles pour des images, de l'audio, de la vidéo, etc., mais tous les modèles n'utilisent pas le même ensemble de paramètres. Les débutants doivent d'abord choisir un modèle spécifique, puis consulter les champs de saisie indiqués sur la page de ce modèle.
Informations officielles Les téléchargements et la documentation dépendent du site officiel.
En quoi cela diffère des fournisseurs d'IA ordinaires
| Plateforme | Ce qu'il faut préparer au préalable | Points d'attention |
|---|---|---|
| Replicate | API Token, page du modèle, paramètres d'entrée | Le SDK Node officiel lit généralement le Token via REPLICATE_API_TOKEN ; les champs d'entrée varient selon le modèle. |
| fal.ai | FAL_KEY, ID du modèle, paramètres d'entrée | Le client JS officiel lit généralement la clé via FAL_KEY ; vous devez également vérifier les champs spécifiques sur la page du modèle. |
| Fournisseur d'IA de chat ordinaire | Clé, URL de base, nom du modèle | Principalement du chat textuel/multimodal, cela ne signifie pas qu'il prend en charge tous les modèles d'images et de vidéos |
Comprendre d'abord la page du modèle spécifique
| Champs de la page | Signification | Comment remplir |
|---|---|---|
| ID / Version du modèle | Quel modèle spécifique appeler | Replicate utilise généralement le format owner/model ou owner/model: version indiqué sur la page du modèle ; fal.ai se remplit selon l'ID de la page du modèle |
| Input schema | Quels champs d'entrée ce modèle requiert | Remplissez chaque élément en fonction de la page du modèle, ne copiez pas les champs d'un autre modèle. |
| Output | À quoi ressemble le résultat retourné ? | Il peut s'agir d'une URL d'image, d'une URL de vidéo, d'un tableau ou d'un objet de tâche. Après l'appel, vous devez extraire le résultat selon le format de retour. |
| Exemple de code | Exemples d'appels officiels générés pour le modèle actuel | Copiez de préférence d'abord l'exemple de la page du modèle, puis remplacez-y votre propre clé et contenu d'entrée. |
Exemple de requête
Ne mélangez pas la syntaxe des deux plateformes suivantes. Utilisez l'onglet correspondant à la plateforme que vous utilisez et remplacez uniquement votre propre clé, l'ID du modèle et les champs d'entrée.
Exemple Replicate pour créer une tâche de prédiction
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);Exemple fal.ai pour appeler le modèle
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);Comment vérifier les champs
Le point le plus crucial sur ces plateformes est la « page du modèle spécifique ». Ne vous contentez pas de copier la clé de la plateforme ; renseignez les champs d'entrée conformément à la page du modèle.
| Erreurs ou symptômes | Causes fréquentes | Solutions |
|---|---|---|
| Modèle non trouvé | L'ID du modèle, le numéro de version ou le namespace est incorrect | Copiez le nom d'appel complet depuis la page du modèle |
| Erreur de champ d'entrée | Le nom de champ, le type ou l'élément obligatoire ne correspond pas aux exigences du modèle actuel | Consultez l'input schema sur la page du modèle et ajoutez les éléments manquants |
| Le résultat retourné est vide | La tâche n'est peut-être pas terminée, ou le champ de sortie ne se trouve pas là où vous le lisez | Affichez d'abord l'intégralité du résultat retourné, puis extrayez l'URL ou le fichier selon la structure de sortie |