Moderate

Create a 'moderate' job

Changed on

Creates a new job that uses AI to analyze a Mux Video asset for inappropriate content. Optional output steering can restrict execution to a time scope in seconds.

post/robots/v1/jobs/moderate

Request

  • Base URL
    https://api.mux.com
  • Auth
    • HTTP basic
    • or HTTP bearer

Request body

passthroughstring

Arbitrary string stored with the job and returned in responses. Useful for correlating jobs with your own systems.

Example request

{
  "parameters": {
    "asset_id": "mux_asset_123abc",
    "include_transcript": true,
    "on_flagged": {
      "action": "delete_playback_ids"
    }
  }
}

Response

Job queued

Example response

{
  "data": {
    "parameters": {
      "asset_id": "mux_asset_123abc",
      "include_transcript": true,
      "on_flagged": {
        "action": "delete_playback_ids"
      }
    },
    "resources": {
      "assets": [
        {
          "id": "abc123asset",
          "meta": {
            "title": "My Video",
            "creator_id": "user123",
            "external_id": "ext456"
          },
          "_links": {
            "self": {
              "href": "/video/v1/assets/abc123asset"
            }
          }
        }
      ]
    },
    "outputs": {
      "thumbnail_scores": [
        {
          "time": 0,
          "sexual": 0.01,
          "violence": 0.02
        },
        {
          "time": 30,
          "sexual": 0.03,
          "violence": 0.15
        }
      ],
      "transcript_scores": [
        {
          "start_time": 0,
          "end_time": 30,
          "sexual": 0.02,
          "violence": 0.04
        },
        {
          "start_time": 25,
          "end_time": 55,
          "sexual": 0.01,
          "violence": 0.21
        }
      ],
      "thumbnail_moderation": {
        "status": "completed"
      },
      "transcript_moderation": {
        "status": "completed"
      },
      "max_scores": {
        "sexual": 0.03,
        "violence": 0.21
      },
      "exceeds_threshold": false
    }
  }
}

Changes

    • info

      added the new optional request property /

    • info

      added the optional property // to the response with the status

    • info

      the response property //////// became required for the status

    • info

      added the required property ////// to the response with the status

    • info

      added the required property ////// to the response with the status

    • info

      added the required property ////// to the response with the status

    • breaking

      removed the required property ////// from the response with the status

    • breaking

      removed the required property ////// from the response with the status

    • breaking

      removed the required property ////// from the response with the status