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

Основна функція API SeeDream Tasks полягає в тому, щоб за допомогою введеного ID завдання, згенерованого API SeeDream Images Generation, перевіряти стан виконання цього завдання. Цей документ детально описує інструкції з інтеграції API SeeDream Tasks, щоб допомогти вам легко інтегрувати та повністю використовувати потужні можливості цього API. За допомогою API SeeDream Tasks ви можете легко реалізувати запити на перевірку стану виконання завдань API SeeDream Images Generation.

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

Щоб використовувати API SeeDream Images Generation, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігши його для подальшого використання.

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

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

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

API SeeDream Tasks можна використовувати для перевірки результатів API SeeDream Images Generation. Щоб дізнатися, як використовувати API SeeDream Images Generation, будь ласка, зверніться до документації API SeeDream Images Generation. Ми візьмемо ID завдання, повернуте сервісом API SeeDream Images 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/seedream/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
  "action": "retrieve"
}'

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

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

{
  "success": true,
  "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
  "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
  "data": [
    {
      "prompt": "a white siamese cat",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
    }
  ]
}

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

success: стан виконання завдання на генерацію відео.
task_id: ID завдання на генерацію відео.
trace_id: ID відстеження генерації відео.
data: список результатів завдання на генерацію зображення.
- image_url: посилання на завдання на генерацію зображення.
- prompt: підказка.
- size: пікселі згенерованого зображення.

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

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

ids: масив ID завдань, які потрібно завантажити.
action: спосіб виконання дії над завданням.

Налаштування, як показано на малюнку нижче:

Приклад коду

Деякі приклади коду наведені нижче:

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

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

{
  "items": [
    {
      "_id": "69498b9bff2676299c5cb7a6",
      "id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
      "api_id": "86ad30f3-0bc8-4b9b-b019-b9fa5b05672e",
      "application_id": "11e25072-de6d-4bd6-81e7-77ee0055499a",
      "created_at": 1766427547.107,
      "started_at": 1766427547.167,
      "finished_at": 1766427560.667,
      "elapsed": 13.5,
      "credential_id": "50892af9-597f-426e-a455-bc1739de95b0",
      "request": {
        "action": "generate",
        "model": "doubao-seedream-4-0-250828",
        "prompt": "білий сіамський кіт"
      },
      "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
      "type": "images",
      "user_id": "b60a9491-1eba-4ab8-a93f-12c0fd81dab4",
      "response": {
        "success": true,
        "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
        "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
        "data": [
          {
            "prompt": "білий сіамський кіт",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
          }
        ]
      }
    },
    {
      "_id": "69498b9bff2676299c5cb7a6",
      "id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
      "api_id": "86ad30f3-0bc8-4b9b-b019-b9fa5b05672e",
      "application_id": "11e25072-de6d-4bd6-81e7-77ee0055499a",
      "created_at": 1766427547.107,
      "started_at": 1766427547.167,
      "finished_at": 1766427560.667,
      "elapsed": 13.5,
      "credential_id": "50892af9-597f-426e-a455-bc1739de95b0",
      "request": {
        "action": "generate",
        "model": "doubao-seedream-4-0-250828",
        "prompt": "білий сіамський кіт"
      },
      "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
      "type": "images",
      "user_id": "b60a9491-1eba-4ab8-a93f-12c0fd81dab4",
      "response": {
        "success": true,
        "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
        "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
        "data": [
          {
            "prompt": "білий сіамський кіт",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
          }
        ]
      }
    }
  ],
  "count": 2
}

Повернення результату містить кілька полів, де items містить конкретну інформацію про пакетні завдання, кожне завдання має таку ж інформацію, як і в попередньому запиті на одинокий завдання.

items, всі конкретні деталі пакетного завдання. Це масив, кожен елемент масиву має таку ж структуру, як і результат запиту на одинокий завдання.
count, кількість пакетних запитів.

Кожен об’єкт завдання в пакетному результаті також має наступні поля часу.

created_at, час створення завдання, Unix-час (секунди, з плаваючою комою).
started_at, час початку виконання завдання, Unix-час (секунди, з плаваючою комою).
finished_at, час завершення завдання, Unix-час (секунди, з плаваючою комою). Поле не повертається, якщо завдання не завершено.
elapsed, час виконання завдання, одиниця виміру - секунди (з плаваючою комою, зберігається 3 знаки після коми). Поле не повертається, якщо завдання не завершено.

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": ["84d1544a-9043-4dde-a98b-e889dacd75f6","84d1544a-9043-4dde-a98b-e889dacd75f6"],
  "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": "не вдалося отримати"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Висновок

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

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

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

Проксі

Advanced

Coding

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

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

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

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

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

Приклад коду

CURL

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

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

Приклад коду

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

CURL

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

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

Висновок

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

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

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

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

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

​CURL

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

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

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

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

​CURL

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

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

​Висновок

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

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

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

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

Приклад коду

CURL

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

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

Приклад коду

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

CURL

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

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

Висновок