раздел 02

Как использовать

Прежде чем встраивать fal.ai в код, стоит пройти короткий путь в браузере: зарегистрироваться, взять ключ и попробовать модель руками. Так вы поймёте, что именно вызывать и какие параметры передавать.

1
Регистрация
Заведите аккаунт на fal.ai. Это даёт доступ к каталогу моделей и личному кабинету.
2
Получить ключ (FAL_KEY)
В кабинете выпустите API-ключ. Именно его код будет передавать в переменной окружения FAL_KEY. Ключ - это доступ к вашему аккаунту и тарификации, храните его как пароль.
3
Playground
Откройте страницу нужной модели и попробуйте её прямо в UI: введите промпт и параметры, запустите, посмотрите результат. Так проверяете модель без единой строки кода.
4
Выбрать модель и параметры
Определитесь, какая модель решает вашу задачу, и зафиксируйте параметры (промпт, размер, длительность и прочее). Эти же значения потом пойдут в API-запрос.

Почему playground важен

Playground - это та же модель, что и по API, только с формой вместо кода. Подобрав в нём рабочий промпт и параметры, вы переносите ровно эти значения в запрос. Это экономит время: вы не отлаживаете параметры через код, а сначала находите хороший результат руками.

На что смотреть при выборе модели

  • Тип медиа: модель должна делать именно то, что нужно (картинка, видео, аудио, апскейл).
  • Параметры: какие поля принимает модель и какие из них влияют на результат сильнее всего.
  • Скорость и формат результата: успевает ли ответить в запросе или задачу лучше слать в очередь, и в каком виде возвращается медиа (как правило, URL).

После этого можно переходить к интеграции - вызову модели из кода.