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

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

Чтобы использовать SeeDream Images Generation API, сначала перейдите в консоль Ace Data Cloud и получите ваш API Token для дальнейшего использования. Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вас пригласят зарегистрироваться и войти. После завершения вы будете автоматически возвращены на текущую страницу. Один API Token позволяет вызывать все сервисы платформы, не нужно отдельно запрашивать для каждого сервиса. При первом запросе предоставляется бесплатный лимит, чтобы вы могли попробовать; при недостатке лимита вы можете пополнить общий баланс в консоли.
📘 Полная документация: SeeDream Images Generation API →

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

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

​
Пример изображения задачи

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

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

​
Пример кода

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

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

​
CURL

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

После успешного запроса API вернет информацию о деталях этой задачи. Например:
Возвращаемый результат содержит несколько полей, описание которых приведено ниже:
  • success: статус выполнения задачи по генерации видео.
  • task_id: ID задачи по генерации видео.
  • trace_id: ID отслеживания видео.
  • data: список результатов задачи по генерации изображений.
    • image_url: ссылка на задачу по генерации изображения.
    • prompt: подсказка.
    • size: пиксели сгенерированного изображения.

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

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

​
Пример кода

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

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

После успешного запроса API вернет конкретную информацию о всех пакетных задачах. Например:
Возвращаемый результат содержит несколько полей, среди которых items включает в себя конкретные детали пакетных задач, каждая задача имеет такую же структуру полей, как и вышеупомянутое.
  • items, все конкретные детали пакетных задач. Это массив, каждый элемент массива имеет такую же структуру, как и результат запроса одной задачи.
  • count, количество пакетных задач в данном случае.
Каждый объект задачи в пакетном результате также содержит следующие временные поля.
  • created_at, время создания задачи, Unix временная метка (секунды, с плавающей точкой).
  • started_at, время начала выполнения задачи, Unix временная метка (секунды, с плавающей точкой).
  • finished_at, время завершения задачи, Unix временная метка (секунды, с плавающей точкой). Поле не возвращается, если задача не завершена.
  • elapsed, время выполнения задачи, в секундах (с плавающей точкой, с 3 знаками после запятой). Поле не возвращается, если задача не завершена.

​
CURL

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

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

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

​
Заключение

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