Kling, Wan и Seedance через один API: где общий доступ, а где разные параметры

Что действительно можно объединить

Для вашего приложения удобно иметь один порядок: выбрать модель, собрать материалы, проверить настройки, создать задание и дождаться результата. Ключ Celestria Gate остаётся одним. Авторизация, сохранение ID и связь с пользовательским заказом тоже могут быть общими, даже если поставщики моделей различаются.

Различия моделей выражаются их схемами, а не выбором API поставщика клиентом. Текстовое описание есть у многих вариантов, но управление длительностью, звуком, камерой и референсами устроено по-разному. Нельзя принять одинаковый объект настроек и молча выбросить неудобные поля, чтобы любая модель ответила успехом. Все проверки и отправки проходят через /v1/media.

Ниже сравниваем конкретные варианты: Kling 3 Pro text-to-video, Wan 2.2 A14B Turbo text-to-video и Seedance 1.5 Pro text-to-video. Это не сводка обо всех поколениях трёх семейств. Новые версии требуют отдельной схемы и не наследуют автоматически ограничения или преимущества выбранного примера.

Один контракт для всех трёх семейств

Для каждой модели используйте GET /v1/media/models/schema?model=…&operation=…, POST /v1/media/estimate, POST /v1/media/generations и GET /v1/media/generations/:id. Ключ Celestria Gate остаётся одним. Клиент задаёт модель, режим и материалы; Gate определяет совместимого провайдера автоматически. Наличие или отсутствие второго предложения не меняет адреса ваших вызовов.

Канонические ID для этого сравнения: kwaivgi/kling-v3.0-pro, alibaba/wan-2.2-a14b-turbo и bytedance/seedance-1-5-pro. У всех в рассматриваемом сценарии операция text-to-video. Эти идентификаторы обозначают конкретные версии; короткие слова kling, wan и seedance их не заменяют. При добавлении нового поколения возьмите id из текущего каталога, а не составляйте его по памяти.

В каждом JSON есть model и input с обязательной operation. duration, когда она поддерживается, задаётся числом. Общие поля остаются прямо в input, а дополнительные настройки размещаются в input.parameters по схеме. Так приложение сохраняет один цикл заказа, не теряя реальные ограничения выбранной модели. Самостоятельно передавать provider или секрет поставщика для этого не нужно.

Сравнение полей на конкретных версиях

Таблица показывает общий смысл параметров для выбранных версий. Конкретные значения подтверждайте текущей схемой Gate; официальные документы разработчиков помогают понять возможности, но в запрос используется контракт /v1/media. Наличие режима в описании не отменяет проверку коммерческой готовности, текущего тарифа и совместимости всех обязательных настроек.

У Kling и Seedance общее поле duration передаётся числом. Wan Turbo из этого сравнения не предлагает отдельную duration в проверенном наборе полей. Добавить duration: 5 только ради одинакового JSON нельзя: отсутствие управления длительностью остаётся существенным отличием. В строгом сравнении вариант без нужного обязательного параметра не является полным эквивалентом.

Для звука опасны неявные значения. Если схема Kling или Seedance разрешает generate_audio, немой тест задаёт false явно. Если в выбранной схеме настройки нет, её нельзя выдумывать. Это не утверждение обо всём семействе Wan: другое поколение имеет собственную схему. Модельные настройки камеры и обработки также проверяются отдельно в parameters.

Общий запрос Wan без неподдерживаемой длительности

Представим простой тест: керамическая чашка медленно поворачивается на столе, камера неподвижна, надписей нет. Для выбранного Wan Turbo явно зададим разрешение и пропорции. Отдельное требование «ровно 5 секунд» этот пример не выражает: нужное управление должно присутствовать в текущей схеме, а не только в пожелании пользователя.

Ниже — тело будущего POST /v1/media/generations. Оно использует канонический alibaba/wan-2.2-a14b-turbo и operation: text-to-video. Перед запуском получите общую схему этой модели, затем отправьте тот же JSON в /v1/media/estimate. Это пример формата, а не выполненный платный запрос и не обещание подтверждённого тарифа.

Ключ API не вставляется внутрь JSON: его передаёт ваш сервер отдельным Authorization-заголовком при обращении к Gate. Сам запрос можно копировать без секрета. Если понадобятся дополнительные настройки, добавляйте их в input.parameters только после проверки схемы; пользователь не выбирает иной API или провайдера ради таких параметров.

{
  "model": "alibaba/wan-2.2-a14b-turbo",
  "input": {
    "operation": "text-to-video",
    "prompt": "A ceramic cup slowly rotates on a wooden table. One continuous shot, a fixed camera, soft daylight. No text.",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}

Общий запрос Kling: задайте только подтверждённые настройки

Для Kling используйте канонический model, обязательную input.operation и параметры общей схемы. Пример включает duration: 5, aspect_ratio: 16:9 и generate_audio: false. resolution намеренно отсутствует: точный размер требует подтверждённой поддержки. Gate проверяет совместимость маршрутов без потери заданных требований; неподходящая настройка не удаляется ради запуска.

Это не повод подписывать результат «гарантированные 1920×1080». Разрешение, полученное в конкретном файле, проверяется после генерации. Если точные размеры обязательны для интеграции, включите их в критерии выбора модели и проверьте допустимый контракт до платной отправки. Название Pro само по себе таких гарантий не даёт.

У Seedance сначала получите его общую схему. Даже похожий набор полей не доказывает совпадение defaults и цены. Параметры звука и размера задавайте осмысленно; специфические настройки помещайте только туда, где их допускает схема. Ошибка совместимости лучше тихой потери важного требования клиента.

{
  "model": "kwaivgi/kling-v3.0-pro",
  "input": {
    "operation": "text-to-video",
    "prompt": "A ceramic cup slowly rotates on a wooden table. One continuous shot, a fixed camera, soft daylight. No text.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio": false
  }
}

Как сравнить три модели без подмены условий

Составьте два отдельных набора: строгий заказ с обязательными настройками и исследовательский тест похожей сцены. В строгом заказе вариант без нужной длительности или звука не является полным конкурентом. В исследовательском тесте его можно посмотреть, но отличия должны быть явно подписаны, иначе минимальная цена будет вводить в заблуждение.

Оценку качества разложите на наблюдаемые свойства: форма чашки, неподвижность камеры, отсутствие лишнего текста, плавность поворота и стабильность фона. Для персонажей добавляются руки, лицо, одежда и сохранение движения. Не выставляйте объективные баллы по рекламным словам или одному удачному кадру из ролика.

Для каждого запуска сохраните полный запрос, исходники, время ожидания, итоговую длительность и размер файла, provider и окончательную стоимость. Сравнивайте стоимость приемлемого результата с учётом числа попыток. Три дешёвых неудачных ролика могут оказаться дороже одной подходящей генерации без дополнительных повторов.

Автовыбор провайдера не означает автовыбор семейства

Общий Gate-маршрут может сравнить подтверждённые совместимые предложения одной модели. Если все сопоставимые цены известны, reason объяснит выбор меньшей цены. Если подошёл один маршрут или сравнение неполное, ответ укажет это. Он не утверждает, что выбранная модель дешевле любого другого семейства.

Kling не должен незаметно превращаться в Wan из-за стоимости. Для такой смены требуется новое решение о качестве, параметрах и ожидаемом результате. В интерфейсе это можно оформить как явный выбор более бюджетного варианта, который пользователь понимает до отправки, а не как скрытую оптимизацию после оплаченного заказа.

Канонический ID сохраняет конкретную идентичность модели. Fast, Turbo, Standard и Pro могут означать разные версии или возможности. Автоматически объединять их под одним названием опасно: клиент получит другой контракт и не поймёт, почему результаты и расходы перестали воспроизводиться. Одновременно одно API остаётся общим для всех этих осмысленно выбранных вариантов.

Практический план подключения трёх семейств

Начните с одной задачи и трёх точных кандидатов. Получите каталог, проверьте готовность, загрузите исходные или общие схемы и заполните таблицу обязательных настроек. Исключите несовместимые варианты из строгого сравнения. Остальным подготовьте отдельные корректные тела, а не один JSON с десятком необязательных полей на все случаи.

Проверьте корректность всех тел через схемы /v1/media/models/schema и оценки /v1/media/estimate без платной генерации. Затем согласуйте ограниченный реальный набор запусков через тот же /v1/media/generations. Результаты подпишите как результаты конкретных заказов, а не доказанную оценку всего бренда. Список моделей в вашем чате можно расширять по мере такой проверки.

Если позже появится новая версия Wan или Seedance, повторите именно эту процедуру. Сохранённый старый запрос остаётся историей старой модели, а новая версия получает свои параметры и тест. Это чуть больше внимания при подключении, зато один ключ действительно превращается в удобный доступ без путаницы в возможностях и расходах.

Частые вопросы

Нужны ли три отдельных ключа?

Для обращения через Celestria Gate используется ключ Gate. Разные схемы моделей не требуют выдавать клиентскому приложению отдельные ключи fal или OpenRouter.

Можно ли отправлять один JSON всем трём моделям?

Только если его смысл и поля подтверждены для каждого конкретного режима. В выбранных примерах управление длительностью, разрешением и звуком различается, поэтому универсальная слепая отправка некорректна.

Почему Wan Turbo не получил duration: 5?

В проверенном наборе полей выбранной Wan Turbo отдельной настройки duration нет. Общий API не выдумывает возможности модели: передавайте только разрешённые поля, а обязательное требование длительности учитывайте при выборе другой совместимой модели.

Gate сам заменит дорогой Kling на дешёвый Wan?

Нет. Автовыбор касается совместимых маршрутов подтверждённой модели. Смена семейства — отдельный осмысленный выбор с проверкой требований и качества.

Источники

• Документация Celestria Gate
• Текущий общий каталог Gate
• Тарифы моделей fal
• Подтверждённые расходы fal: Billing Events
• Kling 3 Pro: fal
• Wan Turbo: fal
• Seedance 1.5 Pro: fal