Інтеграція та використання 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, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігши його для подальшого використання.

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

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

Приклад запиту

API SeeDance Tasks можна використовувати для перевірки результатів API SeeDance Video Generation. Щоб дізнатися, як використовувати API SeeDance Video Generation, будь ласка, зверніться до документації API SeeDance Video Generation. Розглянемо приклад з ID завдання, яке повертає сервіс API SeeDance Video Generation. Припустимо, у нас є 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"
}

Висновок

Завдяки цьому документу, ви дізналися, як використовувати API SeeDance Tasks для запиту всіх деталей одиничних або пакетних завдань. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Проксі

Advanced

Coding

Інтеграція та використання API SeeDance Tasks

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

Приклад запиту

Приклад завдання

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Приклад відповіді

Пакетний запит

Приклад коду

Приклад відповіді

CURL

Обробка помилок

Приклад відповіді на помилку

Висновок

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

​Приклад запиту

​Приклад завдання

​Налаштування заголовків запиту та тіла запиту

​Приклад коду

​CURL

​Приклад відповіді

​Пакетний запит

​Приклад коду

​Приклад відповіді

​CURL

​Обробка помилок

​Приклад відповіді на помилку

​Висновок

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

Приклад запиту

Приклад завдання

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Приклад відповіді

Пакетний запит

Приклад коду

Приклад відповіді

CURL

Обробка помилок

Приклад відповіді на помилку

Висновок