Список задач аккаунта

GET

/api/v1/account/tasks

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

Аутентификация, пагинация и ошибки описаны в разделе Начало работы.

Поведение

По умолчанию 24 часа, максимум 31 день, сортировка по внутреннему ID убывающе. Пакетный режим ids не имеет пагинации и meta.from/to. Возвращаются сохраненные метаданные без URL результатов и промптов. GET не опрашивает провайдера, не рассчитывает списания, не возвращает средства и не отправляет Webhook. Пока сохранение видео или расчет не завершены, состояние processing, finished_at=null. Невозможность подтвердить состояние дает 503. Неизвестное начисление равно billing=null. При pending суммы пропускаются; подтвержденные состояния: settled или refunded.

Аутентификация

Authorizationstringзаголовокобязательно

Используйте Bearer YOUR_SYSTEM_ACCESS_TOKEN. API-ключ модели не подходит. Заголовок X-User-Id не требуется.

Параметры

fromstringзапрос

Начало диапазона включительно, RFC 3339 с часовым поясом. Передавайте вместе с to.

Ограничения: date-time.

tostringзапрос

Конец диапазона не включается, RFC 3339 с часовым поясом. Должен быть позже from.

Ограничения: date-time.

modelstringзапрос

Точное совпадение идентификатора модели. Для использования пустая строка соответствует пустому имени модели.

Ограничения: maxLength=191.

cursorstringзапрос

Передавайте предыдущий next_cursor без изменений и сохраняйте фильтры. При изменении условий начните заново.

Ограничения: maxLength=2048.

limitintegerзапроспо умолчанию: 20

Максимальное число элементов на странице.

Ограничения: minimum=1; maximum=50; По умолчанию: 20.

typestringзапрос

Тип задачи. Параметр status не поддерживается.

Ограничения: image, video, music, other.

client_business_idstringзапрос

Точное совпадение бизнес-ID. Пробелы по краям и управляющие символы запрещены.

Ограничения: minLength=1; maxLength=191.

idsstringзапрос

ID задач платформы через запятую, максимум 20 исходных элементов. Несовместим со всеми другими параметрами запроса. Видимые задачи возвращаются без повторов в порядке первого появления; отсутствующие и чужие пропускаются.

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

curl --request GET \
  --url 'https://toapis.com/api/v1/account/tasks?from=2026-11-01T00:00:00Z&to=2026-11-02T00:00:00Z&type=video&limit=20' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'

import requests

response = requests.get(
    "https://toapis.com/api/v1/account/tasks",
    headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
    params={
        "from": "2026-11-01T00:00:00Z",
        "to": "2026-11-02T00:00:00Z",
        "type": "video",
        "limit": "20"
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

const url = new URL("https://toapis.com/api/v1/account/tasks");
url.search = new URLSearchParams({
  "from": "2026-11-01T00:00:00Z",
  "to": "2026-11-02T00:00:00Z",
  "type": "video",
  "limit": "20"
}).toString();

const response = await fetch(url, {
  headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN" },
  signal: AbortSignal.timeout(30_000),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

Поля ответа

Данные примеров вымышлены и предполагают credits_per_usd="100". Используйте коэффициент из ответа API.

Результаты находятся в data.items. Используйте has_more и next_cursor для пагинации. Последний курсор равен null. Общее число записей не возвращается.

codeinteger

Числовой код результата; 0 означает успех.

messagestring

Сообщение ответа; пустое при успехе. Сообщения об ошибках локализуются.

dataobject

Объект результата текущего запроса.

data.itemsobject[]

Записи текущей страницы; [] при отсутствии результатов.

data.items[].idstring

ID задачи платформы для запроса деталей, не бизнес-ID.

data.items[].client_business_idstring | null

Бизнес-ID, сохраненный при создании задачи; отличается от ID задачи платформы. null, если значение неизвестно или неприменимо.

data.items[].api_key_idstring | null

ID связанного ключа модели; null без связи.

data.items[].typestring

Тип задачи. Значения: image, video, music, other.

data.items[].modelstring

Идентификатор модели.

data.items[].statusstring

Публичный статус задачи. При незавершенном сохранении видео или расчете остается processing. Значения: pending, processing, completed, failed.

data.items[].progressinteger

Процент выполнения задачи, от 0 до 100.

data.items[].created_atstring | null

Время создания. Время в RFC 3339 с часовым поясом. null, если значение неизвестно или неприменимо.

data.items[].finished_atstring | null

Подтвержденное время завершения задачи; null при обработке или отсутствии подтверждения. Время в RFC 3339 с часовым поясом.

data.items[].billingobject | null

Подтвержденные начисления задачи; null, если подтвердить нельзя.

data.items[].billing.statusstring

Статус начисления задачи. При pending суммы пропускаются; подтвержденные статусы: settled или refunded. Значения: pending, settled, refunded.

data.items[].billing.creditsstring

Подтвержденная сумма задачи в credits. Пропускается при pending. Десятичная строка для сохранения точности.

data.items[].billing.cost_usdstring

Подтвержденная сумма задачи в USD. Пропускается при pending. Десятичная строка для сохранения точности.

data.has_moreboolean

Есть ли следующая страница.

data.next_cursorstring | null

Передавайте без изменений как cursor с теми же фильтрами. На последней странице равен null.

data.metaobject

Метаданные об источнике, диапазоне и принципах учета.

data.meta.scopestring

Область владельца данных: сам аутентифицированный аккаунт.

data.meta.sourcestring

Источник данных. Локальная конфигурация или реестр не означают актуальное состояние Stripe.

data.meta.consistencystring

Модель согласованности. eventual означает, что записи могут обновляться позже.

data.meta.fromstring

Начало временного диапазона включительно.

data.meta.tostring

Конец временного диапазона не включается.

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

{
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "id": "task_example_01",
        "client_business_id": "order_example_01",
        "api_key_id": "42",
        "type": "video",
        "model": "example-video-model",
        "status": "completed",
        "progress": 100,
        "created_at": "2026-11-01T08:00:00Z",
        "finished_at": "2026-11-01T08:01:00Z",
        "billing": {
          "status": "settled",
          "credits": "2",
          "cost_usd": "0.02"
        }
      }
    ],
    "has_more": false,
    "next_cursor": null,
    "meta": {
      "scope": "self",
      "source": "persisted_tasks",
      "consistency": "eventual",
      "from": "2026-11-01T00:00:00Z",
      "to": "2026-11-02T00:00:00Z"
    }
  }
}