ShareAI Platform Docs

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

Отправка возвращает HTTP 202 с идентификатором задания ShareAI и URL для опроса.

Просмотреть как Markdown
На этой странице
POST https://api.shareai.now/api/v1/videos

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

Базовый URL
https://api.shareai.now
Аутентификация
Bearer API-ключ или утвержденный токен доступа OAuth
Требуемая область
inference or monetization_gateway

Отправка возвращает HTTP 202 с идентификатором задания ShareAI и URL для опроса. Отправьте стабильный Idempotency-Key заголовок для повторных попыток того же запроса. Повторное использование этого ключа с другим вводом отклоняется. Опрос GET /api/v1/videos/{id} выполняется с теми же исходными учетными данными. Состояния включают: в очереди, ожидает, выполняется, завершается, завершено, неудачно и требует проверки. Результат с состоянием "требует проверки" требует согласования команды; опрос никогда не запускает новое поколение.

Перед началом#

Установите SHAREAI_API_KEY на вашем сервере и замените заполнитель модели на текущую включенную модель. Никогда не раскрывайте API-ключ в коде браузера. Модель, учетная запись, учетные данные и провайдер должны разрешать эту операцию. Дополнительные настройки ниже требуют поддержки модели; границы безопасности API не гарантируют, что каждая модель поддерживает каждое значение.

Отправить запрос#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

Поля запроса#

ПолеТипЗначение и ограничения
model обязательнострокаТочный идентификатор включенной публичной модели. Должен объявлять эту операцию и быть разрешен вашими учетными данными.
prompt обязательнострокаНепустой запрос генерации, не более 256 KiB текста в кодировке UTF-8.
durationцелое числоНеобязательная запрашиваемая продолжительность видео в секундах, от 1 до 600, дополнительно ограничивается выбранной моделью. Фактическая возвращенная продолжительность определяет расчет стоимости.
resolutionстрокаСелектор разрешения, поддерживаемый моделью, не более 100 символов; должен соответствовать опубликованному тарифному варианту.
aspect_ratioстрокаСелектор соотношения сторон, поддерживаемый моделью, не более 100 символов.
sizeстрокаРазмер вывода, поддерживаемый моделью, не более 100 символов, например 1024×1024. Не каждая модель поддерживает эту опцию.
generate_audioбулевоНеобязательный выбор звуковой дорожки для видео. Требуется поддержка модели и соответствующий тарифный вариант.
seedцелое числоНеобязательное начальное значение, поддерживаемое моделью. Для видео требуется неотрицательное целое число; воспроизводимость зависит от исполнителя.
frame_imagesмассивНе более двух частей image_url, каждая с frame_type: first_frame или last_frame, без дубликатов. Не объединяйте frame_images и input_references.
input_referencesмассивНе более 16 частей image_url с установленным image_url.url в HTTPS URL или поддерживаемый URL данных изображения. Требуется поддержка модели.
providerобъектНеобязательные предпочтения маршрутизации провайдера. Используйте provider.only для принятых тегов провайдера, а не префикс в ID модели. Ограничения учетной записи и учетных данных все равно применяются.
allow_temporary_retentionбулевоТолько видео. Явное значение true разрешает временное хранение результата на маршрутах, где это требуется. Пропуск/false делает эти маршруты недоступными. Конфликтует с provider.zdr:true; другие операции сохраняют обязательный ZDR.

Прочитать результат#

Успешное выполнение возвращает HTTP 202 с JSON. Отправка возвращает HTTP 202 с идентификатором задания ShareAI и URL для опроса. Отправьте стабильный Idempotency-Key заголовок для повторных попыток того же запроса. Повторное использование этого ключа с другим вводом отклоняется. Опрос GET /api/v1/videos/{id} выполняется с теми же исходными учетными данными. Состояния включают: в очереди, ожидает, выполняется, завершается, завершено, неудачно и требует проверки. Результат с состоянием "требует проверки" требует согласования команды; опрос никогда не запускает новое поколение.

Единицы выставления счетов#

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

Выберите точный идентификатор включенной модели из Console. Ее объявленная операция и возможности ввода/вывода должны соответствовать этой конечной точке; текстовая модель чата не может быть заменена для другой операции. Ваши учетные данные, провайдер и ограничения учетной записи все равно применяются.

Цены и использование#

Тарифы публикуются в AI-кредитах в евро для выбранной модели, провайдера, единиц и вариантов. Оплачиваются только измерения в активном тарифе. Оценка резервирует кредиты перед выполнением; окончательные списания основаны на измеренном использовании. Цены могут зависеть от разрешения, формата вывода или диапазона использования. Проверьте Console Usage для окончательного списания ShareAI. Поля затрат на вышестоящем уровне и байты медиа не преобразуются в вымышленные токены.

Доступ и ошибки#

Используйте inference для утвержденного вывода инференса с сетевыми затратами или monetization_gateway для утвержденной наценки Builder и принятых условий выставления счетов. Доступ только по идентификации не авторизует расходы. Проверка, авторизация модели, недостаток кредитов, ограничения тарифов и ошибки выполнения возвращают структурированный error. После тайм-аута или неопределенной отправки проверьте Usage или видео-задачу перед созданием другого потенциально оплачиваемого запроса.

Временное хранение видео#

Некоторые видео маршруты требуют временного хранения результата на стороне источника, чтобы сгенерированный результат можно было извлечь. Они требуют вашего явного allow_temporary_retention:true согласия на этот запрос видео. Пропуск делает эти маршруты недоступными. Это исключение применяется только к видео и никогда не разрешает обучение модели или хранение для других операций. Явная политика ZDR не может быть ослаблена без уведомления.

JSON

{"allow_temporary_retention": true}

Проверить статус задания#

GET https://api.shareai.now/api/v1/videos/{id}

Прочитайте генерацию видео с ее исходными учетными данными

Базовый URL
https://api.shareai.now
Аутентификация
Bearer API-ключ или утвержденный токен доступа OAuth
Требуемая область
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

JSON выше иллюстрирует стабильные поля задания, а не реальную генерацию. Опросите путь ShareAI с тем же ключом, ожидая между проверками. Состояния "в очереди", "ожидает", "выполняется" и "завершается" означают ожидание; "завершено" предоставляет данные с URL контента ShareAI; "неудачно" и "требует проверки" означают остановку и проверку. Статус повторной попытки читается после временных ошибок, но не отправляйте генерацию автоматически повторно. Другие или отозванные учетные данные не могут извлечь задание.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

Скачать результат#

После завершения каждая запись данных содержит URL контента ShareAI. Извлеките GET /api/v1/videos/{id}/content?index=0 используя те же исходные учетные данные. Конечная точка поддерживает один диапазон байтов HTTP. URL провайдера, частные билеты и учетные данные провайдера никогда не возвращаются. Опрос и загрузка не создают второго запроса на вывод или дополнительного сбора за обработку через Monetization Gateway. Завершенное задание означает, что расчет подтвержден до того, как файл станет доступным для загрузки.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

Опциональные frame_images должны содержать части image_url с first_frame или last_frame. Используйте кадры или эталонные изображения в одном запросе, но не оба одновременно. Длительности моделей, разрешения и соотношения сторон могут быть более ограниченными, чем безопасные пределы API. Вебхуки и произвольные callback URL не поддерживаются.

Последнее обновление 3 ноября 2026

Документация платформы ShareAI
Вся документация

Искать по названию или содержанию.

Спросить об этой странице

Выберите помощника для изучения этой страницы. Вы также можете скопировать страницу и вставить её в ваш диалог.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI