Перейти к основному содержанию
GET
https://dashlyai.cc
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url 'https://dashlyai.cc/v1/tasks/task_01KA040M0HP1GJWBJYZMKX1XS1' \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.dashlyai.cc/f/image/99982369116..."
          ],
          "expires_at": 1763174708
        }
      ]
    }
  }
}
  • Запрос статуса выполнения и результатов асинхронной задачи
  • Обновление статуса и отслеживание прогресса в реальном времени
  • Получение результатов генерации при завершении задачи
  • Поддержка многоязычности (zh/en/ko/ja)
Все задачи генерации выполняются асинхронно. После отправки задачи необходимо запросить статус и результаты через API запроса.

Авторизация

Authorization
string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API ключ:Посетите Страницу управления API ключами для получения API ключаДобавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

Параметры пути

task_id
string
обязательно
ID задачи, возвращенный API генерации
curl --request GET \
  --url 'https://dashlyai.cc/v1/tasks/task_01KA040M0HP1GJWBJYZMKX1XS1' \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.dashlyai.cc/f/image/99982369116..."
          ],
          "expires_at": 1763174708
        }
      ]
    }
  }
}

Ответ

code
integer
Код статуса ответа
data
object
Данные задачи
message
string
Сообщение об ошибке (только при неудаче)

Справка по статусам задач

СтатусОписаниеФинальныйРекомендуемое действие
queuedЗадача отправлена, ожидает в очередиПодождите 2-5 секунд и повторите запрос
in_progressЗадача обрабатываетсяПодождите 3-10 секунд и повторите запрос
completedЗадача успешно завершенаПолучите URL ресурса из result
failedОбработка задачи не удаласьПроверьте информацию об ошибке

Стратегия опроса

Генерация изображений

Начальное ожидание: 2 секунды
Интервал опроса: 3 секунды
Максимальное ожидание: 120 секунд
Типичное время: 5-30 секунд

Генерация видео

Начальное ожидание: 5 секунд
Интервал опроса: 10 секунд
Максимальное ожидание: 300 секунд
Типичное время: 1-5 минут

Срок действия ресурсов

URL сгенерированных изображений и видео действительны 24 часа
  • Загрузите и сохраните ресурсы в течение срока действия
  • Поле expires_at указывает время истечения ресурса (Unix timestamp)
  • После истечения срока ресурсы недоступны; для повторного получения отправьте новую задачу

Коды ошибок

HTTP кодТип ошибкиОписание
400invalid_requestНеверные параметры запроса
401unauthorizedОшибка аутентификации, проверьте API Key
402insufficient_quotaНедостаточно средств
404task_not_foundЗадача не найдена
422content_policy_violationНарушение политики контента
429rate_limit_exceededПревышен лимит запросов
500internal_errorВнутренняя ошибка сервера