Отключение API Sora: экспортируйте ресурсы и перенесите видеопроцессы

API Sora отключается 24 сентября 2026 года. Если ваше приложение по-прежнему отправляет задачи Sora, используйте оставшееся время, чтобы сохранить результаты и проверить заменяющий видеопроцесс. Веб-версия и приложение Sora от OpenAI уже завершили работу 26 апреля 2026 года; эта более ранняя дата не совпадает со сроком API. Уведомление OpenAI о прекращении работы поясняет обе даты и процесс экспорта.

Переход на Kling или Seedance — это не только выбор новой модели. Тела запросов, входные данные-референсы, состояния задач, URL результатов и поддерживаемая длительность могут отличаться. Миграция завершена, когда приложение способно отправить, отслеживать, получить и сохранить приемлемое видео по новому маршруту.

Документация проверена 14 сентября 2026 года. Примеры ниже сверены с опубликованными схемами; это не отчеты о платных тестах генерации.

Что сохранить до отключения API Sora

Начните с инвентаризации задач Sora, которые приложению необходимо сохранить. Сохраните ID задачи поставщика, внутренний ID задачи, модель, промпт, расположение референс-ресурсов, запрошенные настройки, статус и готовый результат. Храните эти записи в соответствии с существующими правилами доступа и хранения.

Для видео, созданных через API, текущий OpenAI API различает метаданные задачи и загружаемый медиаконтент:

Назначение	Путь OpenAI API
Создать видео	POST /v1/videos
Получить метаданные задачи	GET /v1/videos/{video_id}
Скачать завершенный контент	GET /v1/videos/{video_id}/content

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

Для контента, созданного в приложении Sora, используйте процесс экспорта, описанный в уведомлении OpenAI. Не считайте, что экспорт из приложения также архивирует API-задачи вашего приложения. OpenAI описывает возможные финальные окна экспорта и уведомление по электронной почте; уведомление не позволяет обещать ни немедленное удаление каждого ресурса в срок API, ни бессрочное восстановление после него. Архивируйте нужное, пока оно доступно.

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

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

Кандидат	Документированные возможности, которые стоит проверить	Вопросы миграции
Kling 3.0	Нативный звук, генерация нескольких сцен и процессы первого/последнего кадра в официальном руководстве модели	Предоставляет ли выбранный API-маршрут нужный режим, длительность, управление звуком и работу с референсами?
Seedance 2.5	Мультимодальные референсы, редактирование и продление видео, генерация до 30 секунд	Поддерживает ли маршрут требуемое разрешение, роли референсов и комбинацию параметров для задачи?

Это сводки возможностей, а не рейтинги качества. См. руководство модели Kling 3.0 и анонс ByteDance Seedance 2.5. Возможность, доступная в приложении поставщика, не обязательно доступна через каждый API или шлюз.

Seedance и Seedream — разные семейства моделей. Seedance генерирует видео; Seedream 5.0 Pro — модель изображений. Цену генерации изображения нельзя использовать как цену видео за секунду.

Просмотрите каталог моделей Tokenhot, чтобы найти маршруты-кандидаты, затем перед реализацией прочитайте API-страницу выбранной модели. Зафиксируйте точный идентификатор модели и дату оценки, чтобы позднее осмысленно сравнивать результаты.

Адаптируйте тело запроса, а не только базовый URL

Операция создания Sora от OpenAI использует такие поля, как prompt, seconds и size, со своими поддерживаемыми значениями. Документированная операция Tokenhot Seedance 2.5 вместо этого использует content, duration, ratio и resolution. Путь Tokenhot — /v1/video/generations, где video указано в единственном числе.

Следующая отправка текста в видео соответствует документации Tokenhot Seedance 2.5. Установите requests, задайте TOKENHOT_API_KEY в окружении и запускайте ее только если намерены создать потенциально платную задачу.

import json
import os
from pathlib import Path

import requests

record_path = Path("seedance-submission.json")
if record_path.exists():
    raise RuntimeError("A submission record exists; inspect it before creating another job.")

response = requests.post(
    "https://api.tokenhot.ai/v1/video/generations",
    headers={"Authorization": f"Bearer {os.environ['TOKENHOT_API_KEY']}"},
    json={
        "model": "doubao-seedance-2.5",
        "content": [{
            "type": "text",
            "text": "A ceramic cup on a wooden table, slow camera push-in, soft daylight."
        }],
        "duration": 5,
        "ratio": "16:9",
        "resolution": "720p",
        "generate_audio": False,
        "output_format": "mp4"
    },
    timeout=(10, 60),
)
response.raise_for_status()
job = response.json()
task_id = job["id"]
record_path.write_text(json.dumps(job, indent=2), encoding="utf-8")
print(f"Submitted task: {task_id}")

Этот пример отправляет запрос один раз и сохраняет ответ. Тайм-аут сети может сделать результат отправки неопределенным: сервер мог принять задачу, хотя клиент не получил ее ID. Изучите существующий запрос до повторной отправки. Защита локальным файлом удобна для примера, но не является производственным механизмом идемпотентности.

Текущая страница Seedance 2.5 документирует вывод 480p и 720p, длительность от 4 до 30 секунд либо адаптивное значение -1. Для редактирования видео требуются duration=-1 и ratio=adaptive; для задач первого кадра, первого-и-последнего кадра и продления также нужен адаптивный ratio. Проверяйте правила для своего типа задачи, а не копируйте нагрузку текст-в-видео во все режимы. Неподдерживаемые комбинации могут завершиться ошибкой после начала асинхронной обработки. Требования Tokenhot к параметрам.

Разделяйте схемы отправки и опроса

Принятая отправка — не завершенное видео. На странице отправки Seedance 2.5 документирован верхнеуровневый id и статусы, включая queued, processing, succeeded и failed.

Отдельно опубликованная страница запроса задачи Seedance 2.0 документирует GET /v1/video/generations/{task_id} и показывает вложенный ответ: data.status имеет значение SUCCESS, а data.result_url содержит адрес результата. Поскольку страница помечена как 2.0, подтвердите контракт запроса для выбранного маршрута 2.5 до повторного использования парсера опроса 2.0.

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

Ваш worker должен иметь ограниченный интервал опроса, общий дедлайн и явную обработку ошибок аутентификации, ограничения частоты и временных серверных сбоев. Когда локальный дедлайн опроса истекает, сохраните ID задачи, чтобы другой worker мог продолжить проверку. Не отправляйте заменяющую задачу только потому, что исходная выполняется дольше ожидаемого.

После успеха задачи быстро получите результат и сохраните его согласно политике хранения приложения. Считайте подписанные URL результатов временными механизмами доступа, если сервис явно не документирует обратное. Завершенная задача поставщика и безопасно сохраненный клиентский ресурс — разные этапы.

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

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

Полезная метрика оценки:

Cost per accepted clip = total billed evaluation cost / accepted clips

Например, если оценка стоит $12 и дает восемь клипов, отвечающих требованиям, наблюдаемая стоимость составляет $1.50 на принятый клип. Это иллюстративный расчет, а не ценовое предложение Kling или Seedance. Включайте оплаченные отклоненные попытки в числитель и отдельно учитывайте хранение, монтаж и проверку людьми, если они влияют на решение.

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

Переключитесь до 24 сентября

1. Архивируйте необходимые результаты Sora и проверьте воспроизведение из собственного хранилища.
2. Выберите заменяющий маршрут на репрезентативных клипах и с явными критериями приемки.
3. Проверьте валидацию запросов, записи отправки, разбор ответов, неудачные задачи и получение результатов.
4. Направьте контролируемую долю новой работы на замену и отслеживайте готовые ресурсы, стоимость и ошибки.
5. Прекратите создание новых задач Sora достаточно рано, чтобы обработать оставшуюся работу до срока.
6. Сохраните возможность чтения старых записей задач после переключения и задокументируйте резервный вариант, не зависящий от доступности Sora.

Если вы также выбираете шлюз, руководство по альтернативам OpenRouter охватывает выбор маршрута и проверки совместимости. Для реализации начните с точной страницы видеомодели в документации Tokenhot API, затем проверьте полный жизненный цикл задачи в собственной среде.