Configuração do Replicate / fal.ai
O Replicate e o fal.ai funcionam mais como 'plataformas de APIs de modelos'. Eles podem chamar modelos de imagem, áudio, vídeo, etc., mas nem todos os modelos usam o mesmo conjunto de parâmetros. Iniciantes precisam primeiro escolher um modelo específico e verificar os campos de entrada fornecidos na página desse modelo.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
Como é diferente de provedores de IA comuns
| Plataforma | O que preparar primeiro | Pontos de atenção |
|---|---|---|
| Replicate | Token de API, Página do modelo, Parâmetros de entrada | O Node SDK oficial geralmente lê REPLICATE_API_TOKEN como o Token; os campos de entrada variam para diferentes modelos. |
| fal.ai | FAL_KEY, ID do modelo, Parâmetros de entrada | O cliente JS oficial geralmente lê FAL_KEY como a Key; você também precisa verificar os campos na página específica do modelo. |
| Provedor de IA de Chat comum | Key, URL base, Nome do modelo | Principalmente chat de texto/multimodal, não significa que ofereça suporte a todos os modelos de imagem e vídeo |
Primeiro entenda a página do modelo específico
| Campos da página | O que significa | Como preencher |
|---|---|---|
| Model ID / Versão | Qual modelo específico chamar | O Replicate geralmente usa o formato owner/model ou owner/model:versão informado na página do modelo; o fal.ai é preenchido de acordo com o ID na página do modelo |
| Input schema | Quais campos de entrada este modelo exige | Preencha cada item de acordo com a página do modelo; não copie campos de outro modelo. |
| Output | Qual é a estrutura do resultado retornado? | Pode ser a URL de uma imagem, URL de vídeo, array ou objeto de tarefa. Após a chamada, você precisa extrair o resultado de acordo com o formato de retorno. |
| Código de exemplo | Exemplos oficiais de chamada gerados para o modelo atual | Dê preferência a copiar primeiro o exemplo atual da página do modelo e depois substituir pela sua própria Key e conteúdo de entrada. |
Exemplo de requisição
Não misture a sintaxe das duas plataformas a seguir. Use a aba correspondente à plataforma que você estiver usando e apenas substitua sua própria Key, ID do modelo e campos de entrada.
Exemplo do Replicate para criar uma tarefa de previsão
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);Exemplo do fal.ai para chamar o 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);Como verificar os campos
O mais importante nessas plataformas é a "página do modelo específico". Não se limite a copiar a Key da plataforma; preencha os campos de entrada de acordo com a página do modelo.
| Erros ou comportamentos | Causas comuns | Soluções |
|---|---|---|
| Modelo não encontrado | O ID do modelo, número da versão ou namespace está incorreto | Copie o nome completo de chamada a partir da página do modelo |
| Erro no campo de entrada | O nome do campo, tipo ou item obrigatório não atende aos requisitos do modelo atual | Verifique o input schema na página do modelo e adicione os itens que estiverem faltando |
| O resultado retornado está vazio | A tarefa pode não ter sido concluída ou o campo de saída não está no caminho que você está lendo | Primeiro imprima todo o resultado retornado e depois extraia a URL ou o arquivo de acordo com a estrutura de saída |