Configuración de Replicate / fal.ai
Replicate y fal.ai son más bien «plataformas de API de modelos». Pueden invocar modelos de imagen, audio, vídeo, etc., pero no todos los modelos utilizan el mismo conjunto de parámetros. Los principiantes deben elegir primero un modelo específico y luego consultar los campos de entrada indicados en la página de dicho modelo.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
En qué se diferencia de los proveedores de IA convencionales
| Plataforma | Qué necesitas preparar primero | Puntos a tener en cuenta |
|---|---|---|
| Replicate | API Token, página del modelo, parámetros de entrada | El SDK oficial de Node suele leer el token desde REPLICATE_API_TOKEN; los campos de entrada varían según el modelo. |
| fal.ai | FAL_KEY, ID del modelo, parámetros de entrada | El cliente JS oficial suele leer la clave desde FAL_KEY; también debes consultar los campos en la página del modelo específico. |
| Proveedor convencional de Chat IA | Key, Base URL, nombre del modelo | Principalmente chat de texto/multimodal; no implica que admita todos los modelos de imagen y vídeo |
Primero comprende la página del modelo específico
| Campos de la página | Qué significa | Cómo rellenar |
|---|---|---|
| Model ID / Version | Qué modelo específico invocar | Replicate suele utilizar el formato owner/model o owner/model: version indicado en la página del modelo; fal.ai se completa según el ID de la página del modelo |
| Input schema | Qué campos de entrada requiere este modelo | Rellena cada elemento según la página del modelo; no copies campos de otro modelo. |
| Output | ¿Cómo es el resultado devuelto? | Puede ser una URL de imagen, URL de vídeo, un array o un objeto de tarea. Tras la invocación, debes extraer el resultado según el formato de retorno. |
| Example code | Ejemplos de llamada oficiales generados para el modelo actual | Es preferible copiar primero el ejemplo actual de la página del modelo y luego sustituir tu propia Key y el contenido de entrada. |
Ejemplo de solicitud
No mezcles la sintaxis de las siguientes dos plataformas. Utiliza la pestaña de la plataforma que estés usando y sustituye únicamente tu propia Key, el ID del modelo y los campos de entrada.
Ejemplo de Replicate para crear una tarea de predicción
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);Ejemplo de fal.ai para invocar el modelo
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ómo verificar los campos
Lo más importante en este tipo de plataformas es la «página del modelo específico». No te limites a copiar la Key de la plataforma; completa los campos de entrada según la página del modelo.
| Errores o síntomas | Causas comunes | Soluciones |
|---|---|---|
| Model not found | El ID del modelo, el número de versión o el namespace son incorrectos | Copia el nombre completo de invocación desde la página del modelo |
| Input field error | El nombre del campo, el tipo o el elemento obligatorio no cumplen los requisitos del modelo actual | Revisa el input schema en la página del modelo y añade los elementos que falten |
| Returned result is empty | Es posible que la tarea no haya finalizado o que el campo de salida no esté en la posición desde la que estás leyendo | Imprime primero el resultado devuelto completo y luego extrae la URL o el archivo según la estructura de salida |