Руководство по миграции
Две платформы могут предлагать одну и ту же задачу и всё равно расходиться в именах полей, значениях по умолчанию, конечных состояниях, смысле ошибок и в том, что считается единицей тарификации. Миграция, начатая со смены базового адреса, находит всё это в бою.
Задача
Чисто переносится только модель. Не переносится всё вокруг: какие поля обязательны, какие значения по умолчанию, как попадает внутрь опорное изображение, когда резервируются деньги и что ваш код должен делать с незнакомым состоянием.
01
Выписывайте сопоставление по каждому эндпоинту, а не выводите его. Ввод проверяется по опубликованной схеме с закрытым additionalProperties, поэтому несопоставленное поле — это 400 на первом же боевом запросе, а не предупреждение в журнале.
02
createTask резервирует оценку и возвращает её в cost с settled: false. Если нынешний поставщик списывает только при успехе, ваша сверка должна понимать резервы до переноса трафика.
03
Девять значений покрывают любой отказ, включая content_rejected: отказ — это конечная задача, а не исключение. Сопоставьте существующие ветки ошибок с этими девятью до переключения, а не после.
Подход
Возьмите один сценарий, запишите его нынешние входы, выходы, отказы и удельную стоимость и повторите те же условия здесь. Сравните оценку из jobs/quote с тем, что платите сегодня, держите оба пути живыми за флагом и повышайте долю, только пока числа сходятся.
Сначала оценка: та же проверка и то же решение о приёме, что и при создании, но без резерва и без запуска генерации.
POST /api/v1/jobs/quote
{
"model": "<publisher>/<model>/text-to-video",
"input": {
"prompt": "A slow aerial drift over a misty pine forest at sunrise",
"duration_seconds": 5,
"resolution": "1080p"
}
}200 OK — nothing reserved, nothing started
{
"code": 200,
"msg": "success",
"request_id": "req_example_quote",
"data": {
"quoteId": "qte_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "<publisher>/<model>/text-to-video",
"estimatedCost": "0.750000",
"maxCharge": "0.750000",
"currency": "USD",
"quantity": "5",
"unit": "second",
"expiresAt": "2026-09-12T12:05:00Z"
}
}Контракт
| Поле или заголовок | Значение или предел |
|---|---|
| POST /api/v1/jobs/quote | no hold · signed quote valid 5 min |
| quoteId + expectedCost | 40901 when the price moved |
| 402 | 40201 balance · 40202 spend cap |
| published call name | immutable · renames keep a 308 |
Проведите по горизонтали, чтобы увидеть все столбцы.
Интеграция
Применимость
Проверки
POST /api/v1/jobs/quote выполняет ту же проверку и то же решение о приёме, что и создание, возвращает estimatedCost, maxCharge, quantity и unit и ничего не резервирует. Подписанная оценка действует пять минут.
Отправляйте quoteId и expectedCost вместе с созданием. Если цена изменилась, приём вернёт бизнес-код 40901 до любого резервирования.
Опубликованное имя остаётся действительным, а переименование сохраняет 308 и псевдоним. Ваша таблица сопоставления не протухает молча между релизами.
Перед запуском
Частые вопросы
Модели
Каждая ссылка ведёт на страницу семейства моделей: входные данные, ограничения, контентная политика и текущая цена за единицу.
Дальше
Переносите по одному сценарию: сопоставьте поля, приведите состояния и ошибки, сравните счёт и переключайтесь с проверенным откатом.
Источник: fal model APIs ↗