predict_virality

Predict virality

Score how a short video is likely to perform: a headline number and a timeline of attention, emotion and reward signals. Takes a finished clip or a video upload of up to sixty seconds; spends credits and returns a queued prediction — poll get_virality_prediction until its status is ready or failed. Pass retry_prediction_id instead of a reference to run a failed prediction again on the same video.

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Adds or updates: Adds or updates; nothing the caller already has is deleted or overwritten.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.

Credits

What the tool's description says about credits, verbatim.

Takes a finished clip or a video upload of up to sixty seconds; spends credits and returns a queued prediction — poll get_virality_prediction until its status is ready or failed.

Inputs

referenceobject (type: "upload") or object (type: "generation") · optional
retry_prediction_idstring · optional
uuid

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "predict_virality",
    "arguments": {}
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "reference": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "upload"
            },
            "upload_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "type",
            "upload_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "generation"
            },
            "generation_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "type",
            "generation_id"
          ],
          "additionalProperties": false
        }
      ]
    },
    "retry_prediction_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

Related tools

get_virality_prediction
Read one prediction by id — the poll — or, with no id, list the account's predictions newest first (`archived: true` lists the archived ones).

Every tool· This page as Markdown