Генерация видео

REST-контракты операций Alibaba Video, HEYGEN AGENT, MARS, MOON, MiniMax, OMNI, SATURN, VECTOR, VENUS и X. Контракты сверены с исходниками 8 сентября 2026 года; доступ и стоимость зависят от аккаунта и выбранной операции.

Подключение и общий цикл

Базовый адрес: https://apergrex.ru/franklab/api. Все таблицы ниже показывают полный путь. Передавайте собственный ключ FrankLab в X-API-Key, для HEYGEN — в Authorization: Bearer. Ключ не вставляйте в URL. Make-лейблы и селекторы выбирают ветку запроса, но не всегда являются полями REST.

export FRANKLAB_BASE_URL="https://apergrex.ru/franklab/api"
# FRANKLAB_KEY is supplied securely by your environment.

Сначала проверьте доступность и оценку для конкретной модели. POST генерации может резервировать Франки; единица F — внутренняя учётная единица. Сохраните ID из ответа, затем опрашивайте именно указанный маршрут. HTTP 200, queued/processing и наличие ID не означают готовность. Для успеха нужны терминальный статус и URL результата. 400 — проверьте поля, 401/403 — доступ, 404 — маршрут или ID, 409 — конфликт, 429 — ограничение частоты. Читайте также прикладной code/success и тело ошибки. После таймаута не создавайте новую платную задачу вслепую. Неподтверждённый возврат не считайте состоявшимся.

Пометка required означает обязательность поля выбранной REST-ветки; дополнительные условные требования описаны рядом. Поля пути и query отмечены явно. Не отправляйте все объединённые поля таблицы одновременно.

Модули

• FrankLab Alibaba Video
• FrankLab HEYGEN AGENT
• FrankLab MARS
• FrankLab MOON
• FrankLab MiniMax
• FrankLab OMNI
• FrankLab SATURN
• FrankLab VECTOR
• FrankLab VENUS
• FrankLab X

FrankLab Alibaba Video

Ограничение на 8 сентября 2026: проверка HappyHorse 1.1 в 480P выявила ошибку завершения lifecycle_conflict: задача принимается, но результат и окончательный расчёт не выдаются. Пока не используйте 480P. Если задача уже создана, сохраните ID и обратитесь в поддержку; повторный POST создаст новую задачу.

HappyHorse 1.1 создаёт видео по тексту или первому кадру. В REST обычно не передают model: Make-лейбл happyhorse-1.1 не является значением REST. Для WAN передайте model:"wan3.0-video". Make-селекторы wan_t2v, wan_i2v, wan_r2v, wan_edit, wan_extend, wan_file, wan_link соответствуют семи REST-операциям в таблице; hh10_edit — это video_edit с model:"happyhorse-1.0-video-edit".

REST не принимает wan3.0-video-prime, хотя этот вариант есть в Make. HappyHorse 1.1 принимает 480P/720P/1080P; HappyHorse 1.0 edit — 720P/1080P. Перед отправкой проверьте доступ к выбранной операции, особенно WAN edit/extend/file/link и HappyHorse edit.

Дескриптор изображения: {storedFileId,url,mimeType,width,height,sizeBytes} собственного файла. Видео WAN: {storedFileId,url,mimeType:"video/mp4",sizeBytes}. Видео HappyHorse edit дополнительно требует измеренные width,height,durationSeconds,fps, допустимы MP4/MOV. Документ требует собственные ID/URL, допустимый MIME и размер; необязательный pageCount не больше 50. Не выдумывайте ID или размеры. /franklab/jobs/upload возвращает только URL, поэтому одного ответа загрузки недостаточно для полного дескриптора Alibaba — это отдельное условие интеграции.

В WAN references поле media:[{type:"reference_image",url:ownedURL}] принимает до 10 изображений. REST DTO также содержит referenceVideos и referenceAudios с метаданными; текущая Make communication эти массивы не отправляет. referenceVideo — другое поле: редактируемый клип. Автодлительность WAN -1 резервирует объём для 30 секунд.

Маршруты и операции

Параметры REST

happyhorse_text_to_video, happyhorse_image_to_video, wan_t2v, wan_i2v, wan_r2v, wan_edit, wan_extend, wan_file, wan_link, hh10_edit

poll_status

estimate

upload_source

Ответ и завершение

Формат code/msg/data. Создание: data.taskId, status=queued. Опрос: queued/processing/completed/failed/error. Готовое видео — data.videoUrl. final_cost_franks, refunded_cost_franks и cost_status описывают расчёт.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/alibaba/videos" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"operation":"text_to_video","prompt":"A blue paper cube rotates on a white background.","resolution":"720P","durationSeconds":3,"ratio":"16:9"}'

Оценка: POST /franklab/api/make/alibaba/estimate. Для Alibaba добавьте media=video и передайте только поля схемы estimate.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/alibaba/status/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab HEYGEN AGENT

Авторизация — партнёрский guard; в REST используйте Bearer с ключом FrankLab. Для partner_heygen нужен ID ранее сохранённого аккаунта этого же партнёра. При создании, опросе, чтении ресурсов и RPC сохраняйте тот же режим аккаунта и credential ID. Основной пример использует FrankLab и не содержит секрет провайдера.

Поля Make avatarId, voiceId, styleId, brandKitId, callbackUrl, callbackId, incognitoMode преобразуются в REST snake_case ниже. filesJson становится настоящим JSON-массивом files. Пагинация: limit и token, в ответе возможны hasMore и nextToken. Для аватара нужен ID конкретного look, а не группы.

Для generate_from_prompt создайте сессию с mode:"generate", опрашивайте сессию до появления video ID, затем /v1/heygen/videos/{videoId} до успешного видео с URL. Ошибка, остановка и отмена терминальны; пустой URL не означает готовность. После таймаута или submission_unknown сначала сверяйте существующие записи сессии/задачи, не повторяйте POST вслепую. Сообщение сессии может запустить новую генерацию и не считается бесплатным чтением. Stop не является возвратом; биллинг собственного и FrankLab-аккаунта различается.

Маршруты и операции

Параметры REST

generate_from_prompt, create_session

list_sessions

list_styles, getHeygenVideoAgentStyles, getHeygenBrandKits

get_session, list_videos, stop_session

get_resource

get_video

send_message

save_heygen_credential

getHeygenAgentAvatarLooks

getHeygenVoices

getHeygenVideoAgentSessions

Ответ и завершение

Формат success=true,data,meta. ID сессии и видео различаются. В сессии: data.sessionId/videoId/status/providerStatus; готовое видео читайте через отдельный endpoint в data.video, videoUrl/downloadUrl. Ошибки: failureCode/failureMessage. Наличие сессии не означает готовность результата.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/heygen/video-agents" \
  -H "Authorization: Bearer $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"providerAccountMode":"franklab","prompt":"Create a short video of a blue paper cube rotating on a white background.","mode":"generate"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/heygen/video-agents/$SESSION_ID" \
  -H "Authorization: Bearer $FRANKLAB_KEY"

FrankLab MARS

Для текста/изображения используется model_name:"mars-v1-5", 3–15 секунд, mode:"std"|"pro"|"4k". Тип входа задаёт маршрут: Make mode:"text2video" нельзя передавать в REST как качество. Для изображения обязателен image либо image_list. Текст не принимает элементы. Для изображения доступны до трёх элементов, совместное использование с голосами отклоняется. Мультисцены задаются через multi_shot, shot_type, multi_prompt:[{index,prompt,duration}].

Эффекты требуют точный effect и сцену, например effect_scene:"single_character",effect:"zoom_out",image:ownedURL; для двух персонажей нужен image_tail. Полный список значений сохранён в машинном контракте. Перенос траектории использует API VECTOR с преобразованием старых Make-алиасов. Опрос ведите по соответствующему семейству маршрутов, сохраняйте весь массив task_result.videos, при ошибке читайте task_status_msg.

Маршруты и операции

Параметры REST

text2video, image2video

poll_status

effects

trajectory_transfer

getAllKusoks, getElementVoices

upload_source

Ответ и завершение

Proxy-формат: code=0 (некоторые маршруты также используют 200), data.task_id. Опрашивайте data.task_status; успешный task_result.videos[] содержит url/id/duration. При ошибке читайте task_status_msg. Поле final_cost_franks интерпретируется вместе с cost_status/cost_unit; reserved не является окончательным расчётом.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/text2video" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model_name":"mars-v1-5","prompt":"A blue paper cube rotates on a white background.","duration":3,"mode":"std","aspect_ratio":"16:9"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/text2video/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab MOON

В Make moon_fast предлагает 480p/720p; moon_base добавляет 1080p/4k; moon_pro — 480p/720p/1080p и mp4/mov. moon_mini доступен в выборе генерации по референсам. Допустимость сочетаний определяют валидаторы модели, а не объединённый список значений.

Первый кадр передаётся как first_frame_image_url, последний — last_frame_image_url. Референсы — массивы строк URL. Обычные ограничения: 9 изображений, 3 видео, 3 аудио. moon_pro расширяет референсы до 30/10/10 с дополнительными общими лимитами; старое поле image_list с первыми кадрами остаётся ограничено девятью. Для edit/extend нужен URL исходного видео; для осмысленного изменения добавьте промпт.

Оценку запрашивайте с тем же телом, отправляйте задачу со стабильным idempotency_key, сохраняйте ID и опрашивайте /make/moon/status/{taskId}. Проверяйте code, phase, status, URL и расчёт вместе: final_cost_franks при cost_status=estimated/reserved ещё не означает окончательное списание.

Длительность — целое 4–15 для обычных моделей. moon_pro допускает -1 (авто) или 4–30; для moon_pro video_edit поле не передавайте либо укажите -1. Для moon_pro edit/extend и первого/последнего кадра ratio не задавайте либо используйте adaptive.

Маршруты и операции

Параметры REST

text_to_video, image_to_video, reference_to_video, video_edit, video_extend, estimate

poll_status

upload_source

Ответ и завершение

Формат code/msg/data. При создании: data.taskId/task_id, status=queued, phase и метаданные идемпотентности. Состояния: queued/processing/completed/failed. Результат: data.videoUrl либо нормализованный URL внутри result, last_frame_url при запросе. При ошибке задачи возможен HTTP 200 с code=500. final_cost_franks при reserved ещё не окончательный расчёт.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/moon/videos" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"operation":"text_to_video","moonModel":"moon_fast","prompt":"A blue paper cube rotates on a white background.","duration":4,"resolution":"480p","ratio":"16:9","generate_audio":false}'

Оценка: POST /franklab/api/make/moon/estimate. Используйте то же тело.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/moon/status/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab MiniMax

REST со stored-file поддерживает все пять сценариев. Для текста нужны конкретное соотношение сторон (21:9,16:9,4:3,1:1,3:4,9:16) и отсутствие референсов. Кадровые сценарии требуют соответствующие собственные ID, ratio:"adaptive" и отсутствие массивов референсов. Для reference нужен хотя бы один образ или видео; одного аудио недостаточно. Повтор ID между массивами отклоняется.

Загрузка URL: {source_type:"url",kind:"image",url:"https://your-public-host.example/synthetic.png"}. Для байтов — multipart source_type=make_file, kind=image, media_file=@synthetic.png; data URI передавайте текстовым файлом data_url_file=@source.dataurl с source_type=data_url. Транспортный предел одного файла 64 MiB; пределы медиа меньше: изображение 30 MiB, видео 50 MiB, аудио 15 MiB. Повторно используйте stored_file_id из ответа.

Direct принимает один JSON-файл, а не JSON-тело. Содержимое для первого кадра: {version:"minimax_h3_direct_v1",idempotency_key:"video-docs-frame-001",scenario:"first_frame_to_video",prompt:"A paper cube rotates.",resolution:"768P",duration:4,first_frame:{source_type:"stored_file",stored_file_id:"OWNED_FILE_ID"}}. Make преобразует бинарные файлы в data URL до создания JSON. В direct разрешены stored_file/url/data_url; make_file как тип внутри JSON не принимается.

Для сверки того же запроса сохраняйте ключ идемпотентности. Другое тело с тем же ключом вызывает конфликт; repeat_token означает намеренную новую генерацию. Учитывайте 429 и интервалы повторов: ошибка GET не отменяет уже созданное видео. Отдельный маршрут MiniMax estimate в этом контроллере не найден.

Маршруты и операции

Параметры REST

upload_media

create_video:text_to_video, create_video:first_frame_to_video, create_video:last_frame_to_video, create_video:first_last_frame_to_video, create_video:reference_to_video

create_video:direct

get_video_task

list_video_tasks

cancel_or_delete_video_task:cancel

cancel_or_delete_video_task:delete

Ответ и завершение

Формат code=200,msg=OK,data. task_id; состояния queued/running/succeeded/failed/cancelled, при succeeded — video с собственным stored_file_id и URL. Поля расчёта: reserved_cost_franks, final_cost_franks, cost_status, usage, error. Списки: data.items/page_num/page_size/total.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/minimax/videos" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"idempotency_key":"video-docs-synthetic-001","scenario":"text_to_video","prompt":"A blue paper cube rotates on a white background.","resolution":"768P","duration":4,"ratio":"16:9"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/minimax/videos/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab OMNI

Режим Google subscription обслуживается отдельным оператором. В проверке 8 сентября 2026 запрос оставался в очереди ручной обработки; автоматическое завершение и срок ожидания не подтверждены. Это ограничение режима подписки, а не всех моделей OMNI.

OMNI — отдельный модуль от старого SATURN-алиаса /v1/videos/omni-video. Используйте /make/omni/videos. В Make model=omni выбирает omni_version, model=veo — veo_version; REST-поле model содержит итоговое конкретное значение. poll_status означает GET, а не операцию создания.

Для image-to-video нужен один источник изображения, для reference-to-video — массив объектов, например {source:"url",image_url:ownedURL,label:"cube"}. В edit/extend передавайте полученный interaction_id этого же партнёра. Extend поддерживает только omni_1_1, версия omni 1.0 его отклоняет. Veo использует свои 4/6/8 секунд, разрешение и negative prompt; эти поля не добавляют возможностей движку Omni. GET /make/omni описывает возможности, но не доказывает успешную генерацию.

google_flow_sub использует отдельный маршрут подписки с execution_mode:"google_subscription" и массивом строк URL. Формат опроса отличается. Обычная загрузка возвращает URL; для file-ID нужен настоящий stored-file. Отдельный estimate в Make OMNI-контроллере отсутствует.

Маршруты и операции

Параметры REST

text_to_video, image_to_video, reference_to_video, edit, extend, veo3, veo3_fast

poll_status

google_flow_sub

upload_source

Ответ и завершение

Make OMNI: code/msg/data; taskId/task_id, status, videoUrl/video_url, interaction_id и поля расчёта. Опрос: completed/failed/processing. Сохраните interaction для edit/extend. google-sub использует proxy task_status/task_result.videos.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/omni/videos" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"omni_1_1","operation":"text_to_video","prompt":"A blue paper cube rotates on a white background.","aspect_ratio":"16:9"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/make/omni/status/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab SATURN

Передавайте model_name:"saturn-v1" или "saturn-v1-5", а не Make-селектор version. Стандартный SATURN принимает текст, изображения, видео-референсы, элементы, голоса и управление несколькими сценами в рамках ограничений модели. Объект изображения — {image_url:ownedURL}; источник в каждом объекте ровно один. Native/base64 ограничен 10 MiB на изображение. Видео-объекты используют video_url, необязательные refer_type и keep_original_sound; голосов не больше двух.

У Turbo два отдельных маршрута и модель saturn-v1-5-turbo; стандартные параметры референсов, мультисцен, звука и качества туда не переносятся. В image Turbo формат определяется изображением, в text Turbo задаётся aspect_ratio. Для продолжения нужен настоящий video_id или собственный source_task_id. Генерация из нескольких изображений имеет отдельные create/status маршруты.

Список и запуск AI presets есть в Make и методах сервиса, но соответствующие controller-маршруты в текущих исходниках отсутствуют: статус BLOCKED. Сохраняйте правильный маршрут опроса для каждого варианта. Старый task ID не должен приводить к новому POST. Legacy /videos/omni-video относится к SATURN, не к Gemini OMNI.

Маршруты и операции

Параметры REST

v1, v1-5

v1-5-turbo:text, v1-5-turbo:image

video_extend

multi_image2video

ai_presets:list

ai_presets:generate

poll_status

getAllKusoks, getElementVoices

upload_source

Ответ и завершение

Proxy-формат: code=0 (некоторые маршруты также используют 200), data.task_id. Опрашивайте data.task_status; успешный task_result.videos[] содержит url/id/duration. При ошибке читайте task_status_msg. Поле final_cost_franks интерпретируется вместе с cost_status/cost_unit; reserved не является окончательным расчётом.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/saturn" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model_name":"saturn-v1","prompt":"A blue paper cube rotates on a white background.","duration":3,"mode":"std","aspect_ratio":"16:9"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/saturn/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab VECTOR

VECTOR переносит движение из видео на опорное изображение. Нужны изображение и публичный URL видео; Make описывает клип 3–30 секунд. character_orientation:"image"|"video" выбирает источник ориентации, keep_original_sound:"yes"|"no" — сохранение звука. Профили: auto/studio/cinema; REST также принимает старые vector-v1/vector-v1-5. Качество std/pro.

Изображение передаётся URL, base64/data URI либо image_file_data с image_file_name. Make-контракт описывает JPG/PNG/WebP до 10 MiB. Необязательные элементы — объекты {element_id}. list_tasks использует GET с query-параметрами, без тела создания. Make-селекторы action/task не являются REST-полями. Для генерации нужны референс-видео и опорное изображение; список задач возвращает только их метаданные.

Маршруты и операции

Параметры REST

create

list_tasks

poll_status

upload_source

Ответ и завершение

Proxy-формат: code=0 (некоторые маршруты также используют 200), data.task_id. Опрашивайте data.task_status; успешный task_result.videos[] содержит url/id/duration. При ошибке читайте task_status_msg. Поле final_cost_franks интерпретируется вместе с cost_status/cost_unit; reserved не является окончательным расчётом.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/motion-control" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"generation_profile":"studio","mode":"std","image":"OWNED_SYNTHETIC_IMAGE_URL","video":"OWNED_SYNTHETIC_MOTION_VIDEO_URL","character_orientation":"image","keep_original_sound":"no","duration":"3"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/motion-control/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab VENUS

Передайте изображение и либо sound_file (URL/base64/native файл), либо существующий audio_id. Make описывает MP3/WAV/M4A/AAC до 5 MiB, 2–60 секунд; для audio ID — 2–300 секунд, не старше 30 дней. Native-поля: image_file_data/image_file_name и sound_file_data/sound_file_name. Не отправляйте оба источника аудио одновременно.

Make создаёт задачу через /v1/videos/avatar/image2video, затем опрашивает /v1/tasks/{taskId}. Успех требует видео в task_result.videos. Сервис имеет учитываемый и старый proxy-путь, выбираемые runtime-флагом; отсутствие полей стоимости не означает нулевую цену или подтверждённый возврат. Расчёт проверяется отдельно.

Маршруты и операции

Параметры REST

create_avatar_video

poll_status

avatar_status

upload_source

Ответ и завершение

Proxy-формат: code=0 (некоторые маршруты также используют 200), data.task_id. Опрашивайте data.task_status; успешный task_result.videos[] содержит url/id/duration. При ошибке читайте task_status_msg. Поле final_cost_franks интерпретируется вместе с cost_status/cost_unit; reserved не является окончательным расчётом.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/avatar/image2video" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"image":"OWNED_SYNTHETIC_AVATAR_URL","sound_file":"OWNED_SYNTHETIC_AUDIO_URL","mode":"std"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/tasks/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

FrankLab X

Передайте operation:"generation" и текст, image_url либо reference_images:[{url:ownedURL}]. Изображение и массив референсов взаимоисключающие. source_mode — только Make-селектор. Для edit/extension нужен video_url, без изображений и референсов; extension допускает отсутствие промпта. Длительность generation/edit 1–15 секунд, extension 2–10; Make предлагает более узкие удобные значения.

Если распознанная модель явно не задана, одно изображение выбирает новейшую image-to-video модель; текст и референсы — совместимую. 1080p допускается только для новейшей генерации по одному изображению. execution_mode:"supergrok" поддерживает лишь генерацию по тексту/изображениям/референсам, требует публичный HTTPS для изображений и отдельный допуск партнёра. Edit/extend и видео-вход не поддерживаются. Не выводите доступность подписки из списка параметров и не переключайте режим после ошибки автоматически.

POST возвращает FrankLab task ID; опрашивайте тот же X-маршрут до терминального статуса и рабочего URL. Сохраняйте cost_status вместе с final_cost_franks. Отдельный estimate в контроллере отсутствует; перед разрешённой генерацией нужна актуальная партнёрская оценка.

Маршруты и операции

Параметры REST

generation:text_to_video, generation:image_to_video, generation:reference_to_video, edit, extension

poll_status

upload_source

Ответ и завершение

Proxy-формат: code=0 (некоторые маршруты также используют 200), data.task_id. Опрашивайте data.task_status; успешный task_result.videos[] содержит url/id/duration. При ошибке читайте task_status_msg. Поле final_cost_franks интерпретируется вместе с cost_status/cost_unit; reserved не является окончательным расчётом.

Минимальный пример

Замените OWNED_* ссылками на собственные файлы. Перед отправкой проверьте доступ к модели, оценку стоимости и доступный баланс.

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/xai" \
  -H "X-API-Key: $FRANKLAB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"operation":"generation","execution_mode":"xai_api","prompt":"A blue paper cube rotates on a white background.","duration":1,"resolution":"480p","aspect_ratio":"16:9"}'

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/v1/videos/xai/$TASK_ID" \
  -H "X-API-Key: $FRANKLAB_KEY"

Загрузка и сохранение результатов

curl --fail-with-body -sS "$FRANKLAB_BASE_URL/franklab/jobs/upload" \
  -H "Authorization: Bearer $FRANKLAB_KEY" \
  -F "file=@synthetic.png;type=image/png"

Ответ загрузки: {"success":true,"data":{"url":"..."}}Копировать. Используйте фактический URL ответа. Здесь нет storedFileId, ширины, высоты, fps или длительности. Для параметров с ID и дескрипторами нужна отдельная подтверждённая запись собственного файла. Скачивайте готовый результат до истечения срока хранения; не публикуйте подписанные URL в логах и отчётах.