Инструкция по интеграции API генерации видео Sora

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

Версия 1 (классический режим): поддерживает параметры duration (10/15/25 секунд), orientation (горизонтальный/вертикальный), size (маленький/большой четкости), ссылки на изображения image_urls, видео персонажа character_url и другие.
Версия 2 (партнерский режим): поддерживает параметры seconds (4/8/12 секунд), разрешение на уровне пикселей size (например, 1280x720), ссылки на изображения input_reference и другие.

Процесс подачи заявки

Чтобы использовать API генерации видео Sora, сначала перейдите в консоль Ace Data Cloud и получите ваш API Token для дальнейшего использования.

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

📘 Полная документация: API генерации видео Sora →

Основное использование (Версия 1)

Сначала ознакомьтесь с основным способом использования Версии 1, который заключается в вводе подсказки prompt, массива ссылок на изображения image_urls и модели model, чтобы получить обработанный результат. Конкретное содержание следующее:

Как видно, мы настроили заголовки запроса, включая:

accept: формат ответа, который вы хотите получить, здесь указано application/json, то есть формат JSON.
authorization: ключ для вызова API, который можно выбрать из выпадающего списка после подачи заявки.

Также настроено тело запроса, включая:

model: модель для генерации видео, поддерживает sora-2 (стандартный режим) и sora-2-pro (высокое качество). При этом sora-2-pro поддерживает duration для видео длительностью 25 секунд, в то время как sora-2 поддерживает только 10 и 15 секунд.
size: четкость видео, small — стандартная четкость, large — HD четкость (только Версия 1).
duration: длительность видео, поддерживает 10, 15, 25 секунд, при этом 25 секунд поддерживается только sora-2-pro (только Версия 1).
orientation: направление кадра, поддерживает landscape (горизонтальный), portrait (вертикальный) (только Версия 1).
image_urls: массив ссылок на изображения, используемых для генерации видео (только Версия 1).
character_url: ссылка на видео персонажа, в видео не могут появляться реальные люди (только Версия 1).
character_start/character_end: время появления персонажа в секундах, диапазон разницы составляет 1-3 секунды (только Версия 1).
prompt: подсказка (обязательное поле).
callback_url: URL для асинхронного обратного вызова результата.
async: необязательный, если установлен в true, интерфейс немедленно возвращает task_id, не требуя предоставления callback_url, затем через соответствующий интерфейс запроса задач можно опрашивать для получения результата.
version: версия API, "1.0" (по умолчанию) или "2.0".

После выбора можно увидеть, что справа также сгенерирован соответствующий код, как показано на изображении:

Нажмите кнопку «Попробовать», чтобы провести тестирование, как показано на изображении, и мы получили следующий результат:

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "sora-2:task_01k7770rgsevxsmtpbn7xnm5gh",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k7770rgsevxsmtpbn7xnm5gh%2Ftask_01k7770rgsevxsmtpbn7xnm5gh_genid_0bf958d3-cae7-4298-b7b6-99ae439a1ea6_25_10_10_14_06_975715%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A30%3A38Z&se=2025-10-16T13%3A30%3A38Z&sks=b&skt=2025-10-10T12%3A30%3A38Z&ske=2025-10-16T13%3A30%3A38Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=8ebb0df1-a278-4e2e-9c20-f2d373479b3a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=jigY6Z5qp8%2BTXYobaW0EAJ4%2Fbx6G7t6V1P0iyDeUq48%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

Возвращаемый результат содержит несколько полей, описание которых следующее:

success: статус выполнения задачи по генерации видео.
task_id: ID задачи по генерации видео.
trace_id: ID отслеживания задачи по генерации видео.
data: список результатов задачи по генерации видео.
- id: ID видео задачи по генерации видео.
- video_url: ссылка на видео задачи по генерации видео.
- state: статус задачи по генерации видео.

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

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "size": "large",
  "duration": 15,
  "orientation": "landscape",
  "prompt": "cat running on the river",
  "model": "sora-2"
}'

Задача по генерации видео из изображений (Версия 1)

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

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

Пример заполнения:

После заполнения автоматически сгенерирован следующий код:

Соответствующий код:

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "large",
    "duration": 15,
    "orientation": "landscape",
    "prompt": "кот бегущий по реке",
    "model": "sora-2",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Нажмите “Запустить”, и вы сразу получите результат, как показано ниже:

{
  "success": true,
  "task_id": "dd392ff0-dcb7-4c7a-afd0-9bd4f65c803a",
  "trace_id": "04fd151c-e942-4c1c-a6ab-9a1b1fe54172",
  "data": [
    {
      "id": "sora-2:task_01k777af4hfmg9g7yfvwsc6zws",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777af4hfmg9g7yfvwsc6zws%2Ftask_01k777af4hfmg9g7yfvwsc6zws_genid_92bae0c5-1703-4a5f-9d9f-c9ed2f9e7176_25_10_10_14_12_924695%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A37%3A32Z&se=2025-10-16T13%3A37%3A32Z&sks=b&skt=2025-10-10T12%3A37%3A32Z&ske=2025-10-16T13%3A37%3A32Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=5j4dibeaSsDmEka5c%2B9CKHZhRPdqfClQ0tIh03TWXsM%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

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

Задача по созданию видео с персонажем (Версия 1)

Если вы хотите выполнить задачу по созданию видео с персонажем, сначала параметр character_url должен содержать ссылку на видео, необходимую для создания персонажа, обратите внимание, что в видео не должно быть реальных людей, иначе это приведет к ошибке, можно указать следующее содержимое:

character_url: ссылка на видео, необходимую для создания персонажа, обратите внимание, что в видео не должно быть реальных людей, иначе это приведет к ошибке.

Пример заполнения ниже:

После заполнения автоматически сгенерирован код, как показано ниже:

Соответствующий код:

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "small",
    "duration": 10,
    "orientation": "landscape",
    "prompt": "кот бегущий по реке",
    "character_url": "https://cdn.acedata.cloud/pdidf5.mp4",
    "model": "sora-2",
    "character_end": 3,
    "character_start": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Нажмите “Запустить”, и вы сразу получите результат, как показано ниже:

{
  "success": true,
  "task_id": "d9bf5461-29b5-47fd-be90-1fe9197df259",
  "trace_id": "b7992643-9207-40d6-956b-7577728acc67",
  "data": [
    {
      "id": "sora-2:task_01k8ykrztefavaypw6xanw305b",
      "video_url": "https://platform.cdn.acedata.cloud/20251101/bee4eeeb4c4660b46dac4548a1ffbc.mp4",
      "state": "succeeded"
    }
  ]
}

Можно увидеть, что сгенерированный эффект - это видео с персонажем, результат аналогичен вышеупомянутому.

Режим Version 2.0

Кроме вышеупомянутого режима Version 1.0, этот API также поддерживает режим Version 2.0, который можно активировать, установив параметр version в "2.0". Режим Version 2.0 поддерживает более короткую продолжительность видео и контроль разрешения на уровне пикселей.

Описание параметров Version 2.0

Параметр	Тип	Обязателен	Описание
`version`	string	Да	Установите в `"2.0"`
`prompt`	string	Да	Подсказка для генерации видео
`model`	string	Нет	`sora-2` (по умолчанию) или `sora-2-pro`
`duration`	integer	Нет	Длительность видео: `4` (по умолчанию), `8`, `12` секунд
`size`	string	Нет	Разрешение: `720x1280` (по умолчанию), `1280x720`, `1024x1792`, `1792x1024`
`image_urls`	array	Нет	Массив URL изображений для справки, используется только первое изображение, размер изображения должен соответствовать параметру `size`
`callback_url`	string	Нет	URL для асинхронного обратного вызова

Основной пример

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "version": "2.0",
  "prompt": "кот бегущий по реке",
  "model": "sora-2",
  "duration": 8,
  "size": "1280x720"
}'

Соответствующий код на Python:

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "version": "2.0",
    "prompt": "кот бегущий по реке",
    "model": "sora-2",
    "seconds": 8,
    "size": "1280x720"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Соответствующий код на JavaScript:

const response = await fetch('https://api.acedata.cloud/sora/videos', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'authorization': 'Bearer {token}',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    version: '2.0',
    prompt: 'кот бегущий по реке',
    model: 'sora-2',
    seconds: 8,
    size: '1280x720'
  })
});
const data = await response.json();
console.log(data);

Формат возвращаемого результата аналогичен версии 1.

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "c0cc8dad-0954-421f-be8d-02eb063b3263",
      "video_url": "https://platform.cdn.acedata.cloud/sora/xxxxx.mp4",
      "state": "succeeded"
    }
  ]
}

Использование эталонного изображения (Версия 2.0)

В режиме Версия 2.0 можно передать эталонные изображения через параметр image_urls, чтобы направить генерацию видео (используется только первое изображение):

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "version": "2.0",
    "prompt": "человек, идущий по красивому саду",
    "model": "sora-2",
    "duration": 4,
    "size": "1280x720",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Примечание: Размер эталонного изображения должен соответствовать параметру size, например, если size равно 1280x720, то размер эталонного изображения должен быть 1280×720.

Сравнение параметров Версии 1.0 и Версии 2.0

Параметр	Версия 1.0	Версия 2.0
`version`	1.0 (по умолчанию)	2.0
`prompt`	✅	✅
`model`	✅ sora-2 / sora-2-pro	✅ sora-2 / sora-2-pro
`duration`	✅ 10/15/25 секунд	✅ 4/8/12 секунд
`orientation`	✅ ландшафт/портрет	❌
`size`	✅ маленький/большой	✅ 720x1280/1280x720/1024x1792/1792x1024
`image_urls`	✅ несколько эталонных изображений	✅ используется только первое изображение
`character_url`	✅	❌
`callback_url`	✅	✅

Асинхронный обратный вызов

Поскольку время генерации видео через API Sora Videos Generation относительно долгое, около 1-2 минут, если API долго не отвечает, HTTP-запрос будет поддерживать соединение, что приведет к дополнительным затратам системных ресурсов, поэтому этот API также поддерживает асинхронные обратные вызовы. Общий процесс: когда клиент инициирует запрос, дополнительно указывается поле callback_url, после того как клиент инициирует API-запрос, API немедленно возвращает результат, содержащий информацию о поле task_id, представляющем текущий идентификатор задачи. Когда задача завершена, результат генерации видео будет отправлен на указанный клиентом callback_url в формате POST JSON, который также включает поле task_id, так что результаты задачи могут быть связаны по идентификатору. Давайте рассмотрим, как это работает на примере. Во-первых, Webhook-обратный вызов — это служба, которая может принимать HTTP-запросы, разработчики должны заменить его на URL своего HTTP-сервера. Для удобства демонстрации используется публичный сайт примера Webhook https://webhook.site/, открыв этот сайт, вы получите URL Webhook, как показано на изображении:

Скопируйте этот URL, и вы сможете использовать его в качестве Webhook, пример здесь: https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa. Далее мы можем установить поле callback_url на указанный выше URL Webhook, одновременно заполнив соответствующие параметры, как показано на изображении:

Нажмите “Запустить”, и вы сразу получите результат, как показано ниже:

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

Подождите немного, и вы сможете наблюдать результаты генерации видео на https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa, как показано на изображении:

Содержимое следующее:

{
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
        {
            "id": "sora-2:task_01k777hjrbfrgs2060q5zvf2a5",
            "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777hjrbfrgs2060q5zvf2a5%2Ftask_01k777hjrbfrgs2060q5zvf2a5_genid_b8e2e5d1-a579-49ca-a21c-cb3869685cce_25_10_10_14_15_147334%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A38%3A49Z&se=2025-10-16T13%3A38%3A49Z&sks=b&skt=2025-10-10T12%3A38%3A49Z&ske=2025-10-16T13%3A38%3A49Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=p4aMqXqkP%2FI1IhOVGCB9JL8vUUvfNBBF12ESpKhKXOk%3D&az=oaivgprodscus",
            "state": "succeeded"
        }
    ]
}

Можно увидеть, что в результате есть поле task_id, остальные поля аналогичны вышеупомянутым, с помощью этого поля можно связать задачи.

Обработка ошибок

При вызове API, если возникает ошибка, API вернет соответствующий код ошибки и информацию. Например:

400 token_mismatched: Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
400 api_not_implemented: Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
401 invalid_token: Неавторизован, недействительный или отсутствующий токен авторизации.
429 too_many_requests: Слишком много запросов, вы превысили лимит частоты.
500 api_error: Внутренняя ошибка сервера, что-то пошло не так на сервере.

Пример ответа об ошибке

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Заключение

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

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Прокси

Продвинутый

Coding

Инструкция по интеграции API генерации видео Sora

Процесс подачи заявки

Основное использование (Версия 1)

Задача по генерации видео из изображений (Версия 1)

Задача по созданию видео с персонажем (Версия 1)

Режим Version 2.0

Описание параметров Version 2.0

Основной пример

Использование эталонного изображения (Версия 2.0)

Сравнение параметров Версии 1.0 и Версии 2.0

Асинхронный обратный вызов

Обработка ошибок

Пример ответа об ошибке

Заключение

​Процесс подачи заявки

​Основное использование (Версия 1)

​Задача по генерации видео из изображений (Версия 1)

​Задача по созданию видео с персонажем (Версия 1)

​Режим Version 2.0

​Описание параметров Version 2.0

​Основной пример

​Использование эталонного изображения (Версия 2.0)

​Сравнение параметров Версии 1.0 и Версии 2.0

​Асинхронный обратный вызов

​Обработка ошибок

​Пример ответа об ошибке

​Заключение

Процесс подачи заявки

Основное использование (Версия 1)

Задача по генерации видео из изображений (Версия 1)

Задача по созданию видео с персонажем (Версия 1)

Режим Version 2.0

Описание параметров Version 2.0

Основной пример

Использование эталонного изображения (Версия 2.0)

Сравнение параметров Версии 1.0 и Версии 2.0

Асинхронный обратный вызов

Обработка ошибок

Пример ответа об ошибке

Заключение