Обзор API Yes Ai для Sora, нейросети генерации видео

API нейросети Sora, разработанной компанией Yes Ai, предоставляет возможность интегрировать функции генерации видео в любые приложения, веб-сайты или проекты.

Нейросеть Sora от компании OpenAI выделяется на фоне конкурентов в создании видео на основе текстовых описаний. Благодаря своему значительному потенциалу, проект постоянно получает обновления и расширения API. Мы настоятельно рекомендуем подписаться на наш канал в Telegram, чтобы всегда быть в курсе самых последних новостей и обновлений.

Для отправки заданий и мониторинга их статусов в нейросети Sora вам понадобится API-токен (ключ авторизации). Подробные инструкции по его получению вы найдёте здесь.

Цена создания видео определяется исходными параметрами. Чтобы получить актуальные данные, воспользуйтесь нашим ботом. Перед тем как интегрировать нейросеть Sora в ваш проект, мы настоятельно советуем провести её тестирование. Если вам нужна дополнительная информация, свяжитесь с нашей службой поддержки через мессенджер Telegram по адресу @yes_ai_support.

Для получения более детальной информации о функционале нейросети Sora рекомендуем ознакомиться с нашей статьей.

генерация видео по текстовому промту: создание видео на основе текста без использования изображений в качестве образцов;
генерация видео по референсному изображению: создание видео, используя предоставленное изображение в качестве основы;
комбинированная генерация видео: создание видео, используя как текстовые описания (промты), так и референсные изображения для более точного результата;
настройка длительности: возможность выбора продолжительности видео в диапазоне от 5 до 20 секунд;
использование анимационных эффектов: добавление уникальности видео с помощью авторских эффектов от OpenAI;
настройка разрешения: поддержка различных форматов разрешения, включая 480p, 720p и 1080p;
выбор ориентации: создание видео в различных ориентациях — альбомной, квадратной или портретной.

Эти возможности превращают API Sora в эффективный инструмент для создания высококачественного видео контента, адаптированного под ваши индивидуальные требования.

POST https://api.yesai.su/v2/yesvideo/aniimage/sora
headers: { Content-Type: application/json, Authorization: Bearer }

Пример API-запроса для создания задания на генерацию видео в Sora.

curl -X POST https://api.yesai.su/v2/yesvideo/aniimage/sora -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{ "prompt": "котенок прыгает", "image_url": "https://yoururl.com/image1.jpeg", "effect_id": 0, "resolution": 480, "dimensions": "9:16", "duration": 15 }'

Параметры настройки:

prompt: '' (необязательно: текстовое описание задания. Требуется, если не указана ссылка на изображение);
image_url: '' (необязательно: URL-адрес изображения. Обязателен, если prompt отсутствует);
effect_id: 0 (необязательно, значение по умолчанию: 0). Доступные эффекты:

0 — Без эффекта
1 — Воздушные шары
2 — Ручная работа
3 — Старая пленка
4 — Нуарный стиль
5 — Оригами

resolution: 480 (необязательно, значение по умолчанию: 480). Возможные варианты разрешения: 480, 720, 1080;
dimensions: '9:16' (необязательно, значение по умолчанию: 1:1). Доступные соотношения сторон: 1:1, 9:16, 16:9;

duration: 15 (необязательно, значение по умолчанию: 5). Возможная продолжительность анимации в секундах: 5, 10, 15, 20.

Возможные ошибки:

['success' => false, 'message' => 'IMAGE_URL_IS_EMPTY'], 400 ['success' => false, 'message' => 'IMAGE_URL_NOT_VALID'], 400 ['success' => false, 'message' => 'IMAGE_FILE_SIZE_NOT_VALID'], 400 ['success' => false, 'message' => 'IMAGE_MIME_TYPE_NOT_VALID'], 400 ['success' => false, 'message' => 'PROMPT_IS_EMPTY'], 400 ['success' => false, 'message' => 'PROMPT_NOT_VALID'], 400 ['success' => false, 'message' => 'PROMPT_AND_IMAGE_URL_IS_EMPTY'], 400 ['success' => false, 'message' => 'RESOLUTION_IS_EMPTY'], 400 ['success' => false, 'message' => 'RESOLUTION_NOT_VALID'], 400 ['success' => false, 'message' => 'DIMENSIONS_IS_EMPTY'], 400 ['success' => false, 'message' => 'DIMENSIONS_NOT_VALID'], 400 ['success' => false, 'message' => 'DURATION_IS_EMPTY'], 400 ['success' => false, 'message' => 'DURATION_NOT_VALID'], 400 ['success' => false, 'message' => 'EFFECT_ID_IS_EMPTY'], 400 ['success' => false, 'message' => 'EFFECT_ID_NOT_VALID'], 400 ['success' => false, 'message' => 'SETTINGS_IS_EMPTY'], 400 ['success' => false, 'message' => 'SETTINGS_NOT_VALID'], 400 ['success' => false, 'message' => 'UNAUTHORIZED'], 401 ['success' => false, 'message' => 'IMAGE_NOT_FOUND'], 404 ['success' => false, 'message' => 'USER_HAS_BEEN_BANNED'], 409 ['success' => false, 'message' => 'USER_HAS_BEEN_DELETED'], 409 ['success' => false, 'message' => 'NOT_ENOUGH_RPOINTS'], 409 ['success' => false, 'message' => 'PROMPT_NSFW_WORDS'], 409 ['success' => false, 'message' => 'PARAMETERS_IS_NOT_ALLOWED'], 409 ['success' => false, 'message' => 'TASK_LIMIT_EXCEEDED'], 409 ['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429 ['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500

При успешной отправке нового задания через API Yes Ai, ответ будет представлен в следующем формате:

['success' => true, 'message' => 'OK', 'results' => ['animation_data' => [ ... ]]], 200

Возможные коды статусов:

"status": 0 (описание: "in queue") - задача находится в очереди (пожалуйста, ожидайте)
"status": 1 (описание: "in progress") - задача обрабатывается (пожалуйста, ожидайте)
"status": 2 (описание: "completed") - задача выполнена (можно приступать к обработке результата)
"status": 3 (описание: "rejected with error") - задача отклонена из-за ошибки (рекомендуется проверить описание причины отказа в полях "comment_ru" и "comment_en")
"status": 4 (описание: "rejected due to timeout") - задача отклонена из-за превышения времени ожидания (следует повторно подать задание).

{ "success": true, // данные успешно получены "message": "OK", "results": { "animation_data": { "id": 15977, // уникальный ID задания в системе Yes Ai "user_id": 1234567890, // ID пользователя, который подал задание "tariff_id": 30, // тарифный план пользователя (0 - Demo, 5 - Micro, 10 - Start, 20 - Standard, 30 - VIP) "type": 23, // тип выполненного задания, 23 - генерация видео в нейросети Sora "styles": [], "settings": { "sora_resolution": 480, "sora_dimensions": "1:1", "sora_duration": 5, "sora_effect_id": 0 }, "child_ids": [], "parent_id": 0, "photo_url": "", "image_url": "https://yourdomain.com/photo1.jpeg", // ссылка с исходным изображением, которое отправил клиент "audio_url": "", "video_url": "", "final_frame_url": "", "result_url": "https://yesai.su/files/yesvideo/animations/1234567890_1734572836727827.mp4", // результат выполнения задания в формате MP4, его необходимо скачать на свой сервер "result_type": "video", "result_data": { "video_fps": 30, // количество кадров в секунду "video_width": 480, // ширина видео в пикселях, которое является результатом выполнения задания "video_height": 480, // высота видео в пикселях, которое является результатом выполнения задания "video_duration": 5, // длительность видео в секундах "video_durrange": 0 }, "comment_ru": "", // комментарий к заданию на русском языке, он заполняется только в том случае, если задание не удалось выполнить "comment_en": "", // комментарий к заданию на английском языке, он заполняется только в том случае, если задание не удалось выполнить "accounting": { "total_cost": 1, // итоговая стоимость выполнения задания в условных единицах "spent_points": 0, // количество ⭐️ баллов, которые были сняты с баланса за выполнение задания. Для Sora поле всегда будет равно 0, т.к. оплата производится в 🔅 монетах "spent_rpoints": 1, // количество 🔅 монет, которые были сняты с баланса за выполнение задания "spent_repost_points": 0, "spent_balance": 0, // количество денег с основного баланса, которое было снято за выполнение задания. Для Sora поле всегда будет равно 0, т.к. оплата производится в 🔅 монетах "spent_rbalance": 0, // количество денег с бонусного баланса, которое было снято за выполнение задания. Для Sora поле всегда будет равно 0, т.к. оплата производится в 🔅 монетах "remaining_points": 1820, // остаток средств на балансе ⭐️ баллов после выполнения задания "remaining_rpoints": 3574.3038666, // остаток средств на балансе 🔅 монет после выполнения задания "remaining_repost_points": 0, "remaining_balance": 0, // остаток средств на основном балансе после выполнения задания "remaining_rbalance": 5019.31631 // остаток средств на бонусном балансе после выполнения задания }, "language": "", "prompt": "ваш промт на любом языке", // оригинальный текст промта, отправленного клиентом - не отображается, если не было отправлено при подаче задания "prompt_en": "your prompt", // текст промта на английском языке - система Yes Ai производит автоматический перевод промтов клиентов "status": 2, // статус задания, где 2 - успешное завершение "status_description": "completed", // текстовое пояснение у статусу задания, где completed означает успешное завершение "start_at": 1735095375, // unixtime, время начала выполнения задания "finish_at": 1735095463, // unixtime, время завершения выполнения задания "created_at": 1735095279, // unixtime, время подачи задания клиентом "updated_at": 1735095463 // unixtime, время последнего обновления статуса задания } } }

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

Пожалуйста, загрузите полученное видео на ваш сервер сразу после завершения обработки задачи.

В системе Yes Ai вы можете создавать задания через API и отслеживать их статусы, следуя установленным правилам.

Требования к изображениям для новых заданий:

максимальный размер файла: до 5 мегабайт для анимационных файлов;
разрешение: не более 2000 пикселей по ширине или высоте;
поддерживаемые форматы: JPEG, JPG, PNG.

Отправка POST-запросов для создания новых задач через API:

Новые задачи можно отправлять не чаще одного раза в секунду.

Максимальное количество задач в очереди Yes Ai (очередь объединяет все типы задач, отправленных через API Yes Ai):

Не более восьми задач в очереди.

Если ваш сервис генерирует задачи чаще, рекомендуется организовать собственную очередь задач.

Отправка GET-запросов для получения статусов выполнения ранее отправленных задач:

Проверять статусы следует не чаще одного раза в секунду.

Все вопросы по использованию API Yes Ai направляйте в официальную техническую поддержку через мессенджер Telegram: @yes_ai_support

Оригинальная инструкция

Обзор API Yes Ai для Sora, нейросети генерации видео

API нейросети Sora от компании Yes Ai предлагает ряд инновационных функций

Руководство: отправка запроса на создание видео с помощью API нейросети Sora

Пример ответа API в формате JSON при проверке статуса выполнения задачи.

Обработка завершённых задач по генерации видео с использованием API Yes Ai (Sora)

Ограничения на создание и отслеживание заданий