Настройка Replicate / fal.ai
Replicate и fal.ai ближе к «платформам API моделей». Они позволяют вызывать модели для изображений, аудио, видео и т. д., но не все модели используют одинаковый набор параметров. Новичкам сначала нужно выбрать конкретную модель, а затем посмотреть поля ввода, указанные на странице этой модели.
Официальная информация Загрузки и документация приведены в соответствии с официальным сайтом.
Чем они отличаются от обычных провайдеров AI
| Платформа | Что нужно подготовить в первую очередь | На что обратить внимание |
|---|---|---|
| Replicate | API Token, страница модели, входные параметры | Официальный SDK для Node обычно считывает токен из REPLICATE_API_TOKEN; поля ввода различаются для разных моделей. |
| fal.ai | FAL_KEY, ID модели, входные параметры | Официальный клиент JS обычно считывает ключ из FAL_KEY; также необходимо проверять поля на странице конкретной модели. |
| Обычный чат-провайдер AI | Ключ, Base URL, имя модели | В основном текстовый/мультимодальный чат, что не означает поддержку всех моделей изображений и видео |
Сначала разберитесь со страницей конкретной модели
| Поля страницы | Что это значит | Как заполнять |
|---|---|---|
| ID / версия модели | Какую именно модель вызывать | Replicate обычно использует формат owner/model или owner/model:version, указанный на странице модели; fal.ai заполняется в соответствии с ID на странице модели |
| Схема ввода (Input schema) | Какие поля ввода требуются этой модели | Заполняйте каждый пункт согласно странице модели, не копируйте поля из другой модели. |
| Вывод (Output) | Как выглядит возвращаемый результат? | Это может быть URL изображения, URL видео, массив или объект задачи. После вызова необходимо извлечь результат в соответствии с форматом ответа. |
| Пример кода | Официальные примеры вызова, сгенерированные для текущей модели | Лучше сначала скопировать текущий пример со страницы модели, а затем заменить ключ и входные данные своими. |
Пример запроса
Не смешивайте синтаксис двух следующих платформ. Используйте вкладку той платформы, с которой работаете, и заменяйте только свой ключ, 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);Как проверять поля
Самое главное на таких платформах — это «страница конкретной модели». Не ограничивайтесь простым копированием ключа платформы; заполняйте входные поля строго по странице модели.
| Ошибки или ситуации | Частые причины | Решения |
|---|---|---|
| Модель не найдена (Model not found) | Неверно указан ID модели, номер версии или пространство имен | Скопируйте полное имя вызова со страницы модели |
| Ошибка входного поля (Input field error) | Имя поля, тип или обязательный параметр не соответствуют требованиям текущей модели | Проверьте схему ввода на странице модели и добавьте недостающие параметры |
| Возвращенный результат пуст | Возможно, задача еще не завершена или поле вывода находится не в том месте, откуда вы его считываете | Сначала выведите в консоль весь возвращенный результат, затем извлеките URL или файл в соответствии со структурой вывода |