Действия с результатом

Что можно сделать

Готовый результат можно доработать: увеличить картинку из сетки Midjourney, продлить видео Veo, разделить песню Suno на дорожки, конвертировать 3D-модель Tripo и так далее. Что можно сделать с задачей прямо сейчас, перечислено в её поле actions: его отдаёт GET /v1/tasks/{id}, когда задача succeeded. В списке задач (GET /v1/tasks) этого поля нет, пустой список значит, что делать с задачей нечего.

Так выглядит сетка Midjourney в ответе GET /v1/tasks/{id} (часть полей и действий опущена):

{
  "id": "TASK_ID",
  "model_key": "midjourney",
  "status": "succeeded",
  "actions": [
    {
      "action": "upscale",
      "title": "Увеличить картинку из сетки",
      "artifact_index": 0,
      "request": {
        "model": "midjourney",
        "settings": {
          "version": "upscale",
          "source_task_id": "TASK_ID",
          "index": 0
        }
      },
      "data": null
    },
    {
      "action": "reroll",
      "title": "Повторить сетку",
      "artifact_index": null,
      "request": {
        "model": "midjourney",
        "settings": {
          "version": "reroll",
          "source_task_id": "TASK_ID"
        }
      },
      "data": null
    }
  ]
}

Запустить действие

Действие это режим той же модели, только работает он с прошлой задачей. В settings значение режима стоит в поле, которое переключает режимы модели (у Midjourney version, у Tripo task_type, у остальных mode), id готовой задачи в source_task_id, а index файла результата в index, если действие работает с одним файлом. В request такой запрос уже собран: отправьте его в POST /v1/price, чтобы узнать цену, и в POST /v1/tasks, чтобы запустить.

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042" \
  --data '{
  "model": "midjourney",
  "settings": {
    "version": "upscale",
    "source_task_id": "TASK_ID",
    "index": 0,
    "upscale_type": "creative"
  }
}'

Поля, которые выбирает человек (описание продления, области правки, части песни), в request не входят: их добавляют по описанию режима на странице модели. Там же значения по умолчанию, которые можно поменять. Результат действия это новая задача со своим id, статусом и файлами, а исходная задача не меняется.

Цена действия зависит от исходной задачи (скорость сетки Midjourney, качество ролика Veo, длина песни) и берётся так же, как у любой задачи: резерв при приёме, списание после успеха. Бывает и нулевая цена, например у сборки картинки из слоёв Seedream. Точную цену покажет POST /v1/price.

Действие работает только с задачами своего кабинета и той же модели, и только пока файлы результата хранятся (7 дней). Одноразовые действия Suno (например, разделение песни на дорожки или WAV) делаются один раз: повтор бесплатно вернёт уже готовый файл.

Действия моделей

Поля, пределы и пример запроса каждого действия на странице модели, в разделе режима.

Ошибки