CyHUBДокументация API v1
Документация API

Задачи и результаты

Статусы, результат и история задач.

Проверить статус

cURL
curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Замените TASK_ID на id принятой задачи. Пока задача в работе, спрашивайте статус раз в несколько секунд. В stage текст того, что модель делает сейчас.

СтатусЗначение
queuedЗадача принята и ждёт очереди.
runningГенерация выполняется.
succeededРезультат готов, деньги списаны.
failedГенерация не удалась, резерв возвращён. Причина в error.
cancelledЗадача отменена, резерв возвращён.

Получить результат

У succeeded в result: caption (описание результата), texts (тексты, например слова песни) и artifacts, файлы с index, kind (image, video, audio, document), filename, size и download_path.

У failed причина в error, на языке кабинета. Резерв уже возвращён, повторный запуск это новая задача.

У черновика Seedance (задача с draft: true) есть поле draft: можно ли пересобрать его в высоком качестве (upscale_status), до какого времени (upscale_until) и готовый запрос для этого (upscale_request). Пересобрать черновик можно один раз, режимом upscale_draft той же модели. У остальных задач draft равно null.

Скачать файлы результата Пересборка черновика Seedance

История

cURL
curl "https://api.cyhub.ai/v1/tasks?limit=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

Фильтры status и model (ключ модели), limit от 1 до 100. Следующая страница: next_cursor из ответа в параметр before.