Интеграция и использование API SeeDance Tasks

Основная функция API SeeDance Tasks заключается в том, чтобы запрашивать статус выполнения задачи, используя ID задачи, сгенерированный API SeeDance Video Generation. В этом документе подробно описывается интеграция API SeeDance Tasks, чтобы помочь вам легко интегрировать и в полной мере использовать мощные функции этого API. С помощью API SeeDance Tasks вы можете легко реализовать запрос статуса выполнения задач API SeeDance Video Generation.

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

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

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

📘 Полная документация: SeeDance Video Generation API →

Пример запроса

API SeeDance Tasks можно использовать для запроса результатов API SeeDance Video Generation. Для получения информации о том, как использовать API SeeDance Video Generation, пожалуйста, обратитесь к документации SeeDance Video Generation API. Мы возьмем в качестве примера один ID задачи, возвращенный сервисом API SeeDance Video Generation, и продемонстрируем, как использовать этот API. Предположим, у нас есть ID задачи: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, далее мы покажем, как передать этот ID задачи.

Пример задачи

Установка заголовков запроса и тела запроса

Request Headers включает:

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

Request Body включает:

id: загруженный ID задачи.
action: способ выполнения операции над задачей.

Настройка, как показано на следующем изображении:

Пример кода

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

Некоторые примеры кода:

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
  "action": "retrieve"
}'

Пример ответа

После успешного запроса API вернет информацию о деталях этой задачи. Например:

{
    "_id": "69480c5cff2676299c7b351d",
    "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
    "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
    "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
    "created_at": 1766329436.091,
    "started_at": 1766329436.151,
    "finished_at": 1766329518.051,
    "elapsed": 81.9,
    "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
    "request": {
        "model": "doubao-seedance-1-0-pro-250528",
        "content": [
            {
                "type": "text",
                "text": "Несколько кадров. Детектив входит в тускло освещенную комнату. Он проверяет улики на столе, поднимая какой-то предмет. Камера переключается на его размышления. --ratio 16:9"
            }
        ],
        "callback_url": "dummy"
    },
    "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
    "type": "videos",
    "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
    "response": {
        "success": true,
        "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
        "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
        "data": {
            "task_id": "cgt-20251221230356-sxgt7",
            "status": "succeeded",
            "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4",
            "last_frame_url": null,
            "model": "doubao-seedance-1-0-pro-250528"
        }
    }
}

Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленного для создания задачи, а поле response — это тело ответа, возвращенное после завершения задачи. Описание полей следующее.

id: ID сгенерированной задачи, используемый для уникальной идентификации этой задачи.
request: информация о запросе в задаче.
response: информация о возвращенном ответе в задаче.
created_at: время создания задачи, Unix временная метка (секунды, с плавающей точкой).
started_at: время начала выполнения задачи, Unix временная метка (секунды, с плавающей точкой).
finished_at: время завершения задачи, Unix временная метка (секунды, с плавающей точкой). Это поле не возвращается, если задача не завершена.
elapsed: время выполнения задачи, в секундах (с плавающей точкой, с 3 знаками после запятой). Это поле не возвращается, если задача не завершена.

Пакетный запрос

Это запрос для получения деталей нескольких ID задач, в отличие от вышеуказанного, здесь необходимо выбрать action как retrieve_batch. Request Body включает:

ids: массив загруженных ID задач.
action: способ выполнения операции над задачей.

Настройка, как показано на следующем изображении:

Пример кода

Некоторые примеры кода:

Пример ответа

После успешного запроса API вернет конкретную информацию о всех пакетных задачах. Например:

{
    "items": [
        {
            "_id": "69480c5cff2676299c7b351d",
            "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
            "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
            "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
            "created_at": 1766329436.091,
            "started_at": 1766329436.151,
            "finished_at": 1766329518.051,
            "elapsed": 81.9,
            "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
            "request": {
                "model": "doubao-seedance-1-0-pro-250528",
                "content": [
                    {
                        "type": "text",
                        "text": "Несколько кадров. Детектив входит в тускло освещённую комнату. Он проверяет улики на столе, поднимая какой-то предмет. Камера переключается на его раздумья. --ratio 16:9"
                    }
                ],
                "callback_url": "dummy"
            },
            "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
            "type": "videos",
            "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
            "response": {
                "success": true,
                "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
                "trace_id": "24b1b09c-5649-4290-98db-eab23e5efcac",
                "data": {
                    "task_id": "cgt-20251221230356-sxgt7",
                    "status": "succeeded",
                    "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4",
                    "last_frame_url": null,
                    "model": "doubao-seedance-1-0-pro-250528"
                }
            }
        },
        {
            "_id": "69480e0dff2676299c7cb98b",
            "id": "d9e576bd-ca14-4c6f-a541-f4734e941dbe",
            "api_id": "44e45d2b-8754-4a93-b793-c63271335f6f",
            "application_id": "1456a4bf-e2f4-4247-9b2d-fb49effc6eca",
            "created_at": 1766329436.091,
            "started_at": 1766329436.151,
            "finished_at": 1766329518.051,
            "elapsed": 81.9,
            "credential_id": "3e20b461-f750-48d3-a1f7-3aea48d15d77",
            "request": {
                "model": "doubao-seedance-1-0-pro-250528",
                "content": [
                    {
                        "type": "text",
                        "text": "Несколько кадров. Детектив входит в тускло освещённую комнату. Он проверяет улики на столе, поднимая какой-то предмет. Камера переключается на его раздумья. --ratio 16:9"
                    }
                ],
                "callback_url": "dummy"
            },
            "trace_id": "e3da01aa-5026-4653-8d07-c68c4fcf466a",
            "type": "videos",
            "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
            "response": {
                "success": true,
                "task_id": "d9e576bd-ca14-4c6f-a541-f4734e941dbe",
                "trace_id": "e3da01aa-5026-4653-8d07-c68c4fcf466a",
                "data": {
                    "task_id": "cgt-20251221231109-cnkhp",
                    "status": "succeeded",
                    "video_url": "https://platform.cdn.acedata.cloud/seedance/eb99ba03-178c-4616-8d19-e625fee2e884.mp4",
                    "last_frame_url": null,
                    "model": "doubao-seedance-1-0-pro-250528"
                }
            }
        }
    ],
    "count": 2
}

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

items, все конкретные детали пакетных задач. Это массив, каждый элемент массива имеет такую же структуру, как и результат запроса одной задачи.
count, количество задач в этом пакетном запросе.

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["9462ca25-468b-45a5-9e75-6f516dedcc80","d9e576bd-ca14-4c6f-a541-f4734e941dbe"],
  "action": "retrieve_batch"
}'

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

При вызове 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"
}

Заключение

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

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

AI Чат

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

AI Видео

AI Аудио

Веб и данные

CAPTCHA

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

Прокси

Продвинутый

Coding

Интеграция и использование API SeeDance Tasks

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

Пример запроса

Пример задачи

Установка заголовков запроса и тела запроса

Пример кода

CURL

Пример ответа

Пакетный запрос

Пример кода

Пример ответа

CURL

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

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

Заключение

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

​Пример запроса

​Пример задачи

​Установка заголовков запроса и тела запроса

​Пример кода

​CURL

​Пример ответа

​Пакетный запрос

​Пример кода

​Пример ответа

​CURL

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

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

​Заключение

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

Пример запроса

Пример задачи

Установка заголовков запроса и тела запроса

Пример кода

CURL

Пример ответа

Пакетный запрос

Пример кода

Пример ответа

CURL

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

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

Заключение