AiVideoAnalysisUpdatedPayload ai.video_analysis.updated@1

Generated at from openvibe-contracts v0.443.0 and openvibe-sdk v0.177.0.

Version
1.0.0
Owner
ai
Visibility
first-party
Status
active
Compatibility
backward
Schema
https://openvibe.network/contracts/events/payloads/ai.video_analysis.updated.v1.json

ai.video_analysis.updated v1 (OpenVibe.AI server/video-analysis/): a video analysis' step changed or it ended. One event per step transition and one at the end, so a page (OpenVibe.Video's, or OpenVibe.Exchange's) can follow a run without polling. The payload carries the run and analysis ids, the step, the progress and the status; never the transcript, a frame or a prompt. Envelope: subject { type: run, id: <run_id> }, visibility internal, priority low (important on failed), actor service:ai.

Fields

FieldTypeRequiredDescriptionConstraints
video_analysis_idstringyes
  • pattern ^run_[0-9A-HJKMNP-TV-Z]{26}$
run_idstringyes
  • pattern ^run_[0-9A-HJKMNP-TV-Z]{26}$
statusenumyes
  • one of "queued", "running", "succeeded", "failed", "cancelled"
stepenumyes
  • one of "probe", "keyframes", "transcript", "describe", "analyse", "explicit", "report", "done", null
progressnumberyes
  • minimum 0
  • maximum 1
stepsarray of objectyes
  • items: no other fields
steps[].keyenumyes
  • one of "probe", "keyframes", "transcript", "describe", "analyse", "explicit", "report"
steps[].statusenumyes
  • one of "pending", "running", "done", "skipped", "failed"
depthenumyes
  • one of "quick", "standard", "deep"
requesteridentity.subject-refyes
on_behalf_ofone ofyes
urlstringyes
  • pattern ^https://
  • format uri
errorone ofyes
occurred_atstringyes
  • format date-time

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: reading
{
  "video_analysis_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "status": "running",
  "step": "describe",
  "progress": 0.58,
  "steps": [
    {
      "key": "probe",
      "status": "done"
    },
    {
      "key": "keyframes",
      "status": "done"
    },
    {
      "key": "transcript",
      "status": "done"
    },
    {
      "key": "describe",
      "status": "running"
    },
    {
      "key": "analyse",
      "status": "pending"
    },
    {
      "key": "explicit",
      "status": "pending"
    },
    {
      "key": "report",
      "status": "pending"
    }
  ],
  "depth": "standard",
  "requester": {
    "type": "service",
    "id": "exchange"
  },
  "on_behalf_of": {
    "type": "user",
    "id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
  },
  "url": "https://openvibe.exchange/video-analysis/run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "error": null,
  "occurred_at": "2026-11-13T21:00:00.000Z"
}
Rejected: progress-over-one
{
  "video_analysis_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "status": "running",
  "step": "describe",
  "progress": 1.5,
  "steps": [],
  "depth": "standard",
  "requester": {
    "type": "service",
    "id": "exchange"
  },
  "on_behalf_of": null,
  "url": "https://openvibe.exchange/video-analysis/run_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "error": null,
  "occurred_at": "2026-11-13T21:00:00.000Z"
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('ai.video_analysis.updated@1', value);   // { valid, errors: [{ path, message }] }