Skip to content

Response Examples

Curated response examples organized by media type. All examples reflect real platform behavior validated by the governance test suite.

Image Response — FULL Profile

POST/api/v1/inspect?profile=full
jsonc
{
  "success": true,
  "responseSource": "fresh",
  "cached": false,
  "processing": {
    "status": "complete",
    "completion": 1,
    "enrichmentsPending": false,
    "completedStages": ["semantic", "mediaFormat", "metadata:image", "preview:thumbnail", "preview:blurhash", "preview:palette"],
    "pendingStages": []
  },
  "data": {
    "identity": {
      "url": "https://www.geekygallery.in/cdn/shop/files/god_16.jpg?v=1726037386&width=1946",
      "finalUrl": "https://www.geekygallery.in/cdn/shop/files/god_16.jpg?v=1726037386&width=1946",
      "mime": "image/jpeg"
    },
    "semantic": { "kind": "direct-media", "semanticType": "image" },
    "playback": { "strategy": "native", "component": "img", "streamable": false, "downloadable": true },
    "metadata": {
      "filename": "god_16.jpg",
      "size": { "bytes": 204800, "formatted": "200 KB" },
      "image": { "colorSpace": "srgb", "hasAlpha": false }
    },
    "preview": {
      "thumbnail": { "url": "/public/thumbnails/generated.jpg", "dimensions": "320x180" },
      "placeholder": { "type": "blurhash", "value": "LEHV6nWB2yk8pyo0adR*.7kCMdnj" },
      "palette": { "dominant": "#112233" },
      "dominantColor": "#112233"
    },
    "diagnostics": { "timings": { "total": 1240, "semantic": 12, "mediaFormat": 85 } }
  },
  "enrichmentSources": {
    "semantic": "fresh", "mediaFormat": "fresh", "metadata:image": "fresh",
    "preview:thumbnail": "fresh", "preview:blurhash": "fresh", "preview:palette": "fresh"
  },
  "projection": { "profile": "full", "hiddenFields": [] }
}

Audio Response — FULL Profile

jsonc
{
  "success": true,
  "responseSource": "fresh",
  "processing": {
    "status": "complete",
    "completion": 1,
    "enrichmentsPending": false,
    "completedStages": ["semantic", "mediaFormat", "metadata:audio"],
    "pendingStages": []
  },
  "data": {
    "identity": {
      "url": "http://commondatastorage.googleapis.com/codeskulptor-assets/Epoq-Lepidoptera.ogg",
      "finalUrl": "http://commondatastorage.googleapis.com/codeskulptor-assets/Epoq-Lepidoptera.ogg",
      "mime": "audio/ogg"
    },
    "semantic": { "kind": "direct-media", "semanticType": "audio" },
    "playback": { "strategy": "native", "component": "audio", "streamable": true, "downloadable": true },
    "metadata": {
      "filename": "Epoq-Lepidoptera.ogg",
      "size": { "bytes": 1024, "formatted": "1 KB" },
      "audio": { "duration": { "seconds": 30, "formatted": "0:30" }, "bitrate": { "bps": 128000, "formatted": "128 kbps" }, "sampleRate": 44100 }
    },
    "preview": {
      "waveform": null,       // planned, not yet available
      "spectrogram": null     // planned, not yet available
    }
  },
  "projection": { "profile": "full", "hiddenFields": [] }
}

Audio Preview

Audio preview omits visual enrichments (thumbnail, blurhash, palette) entirely — they are unsupported. Waveform and spectrogram are null because they are planned but not yet implemented.

Video Response — FAST Profile (Partial)

jsonc
{
  "success": true,
  "responseSource": "fresh",
  "processing": {
    "status": "partial",
    "completion": 0.33,
    "enrichmentsPending": true,
    "completedStages": ["semantic", "mediaFormat"],
    "pendingStages": ["metadata:video", "preview:thumbnail", "preview:blurhash", "preview:palette"]
  },
  "data": {
    "identity": {
      "url": "https://download.blender.org/peach/bigbuckbunny_movies/BigBuckBunny_320x180.mp4",
      "finalUrl": "https://download.blender.org/peach/bigbuckbunny_movies/BigBuckBunny_320x180.mp4",
      "mime": "video/mp4"
    },
    "semantic": { "kind": "direct-media", "semanticType": "video" },
    "playback": { "strategy": "native", "component": "video", "streamable": true, "downloadable": true },
    "metadata": { "filename": "BigBuckBunny_320x180.mp4", "size": { "bytes": 56733664, "formatted": "54.1 MB" } }
    // preview: projection-hidden in FAST for direct media
  },
  "projection": { "profile": "fast", "hiddenFields": ["preview"] }
}

YouTube Response — FAST Profile (Provider-Native)

jsonc
{
  "success": true,
  "responseSource": "fresh",
  "processing": {
    "status": "complete",
    "completion": 1,
    "enrichmentsPending": false,
    "completedStages": ["semantic", "mediaFormat", "oembed"],
    "pendingStages": []
  },
  "data": {
    "identity": {
      "url": "https://youtu.be/GLTTI1NFHus?si=okdNMy6_p0VSqZJG",
      "finalUrl": "https://youtu.be/GLTTI1NFHus?si=okdNMy6_p0VSqZJG",
      "canonicalUrl": "https://www.youtube.com/watch?v=GLTTI1NFHus",
      "mime": "text/html"
    },
    "semantic": { "kind": "embed-media", "semanticType": "embedded-video", "title": "Provider Native Title" },
    "provider": { "name": "youtube", "confidence": 1, "detectionMethod": "url-parser" },
    "playback": {
      "strategy": "iframe", "component": "iframe",
      "embedUrl": "https://www.youtube.com/embed/GLTTI1NFHus",
      "streamable": false, "downloadable": false
    },
    "preview": {
      "thumbnail": { "url": "https://i.ytimg.com/vi/GLTTI1NFHus/hqdefault.jpg" }
      // placeholder: omitted (not provider-native)
      // palette: omitted (not provider-native)
    }
  },
  "enrichmentSources": { "semantic": "fresh", "mediaFormat": "fresh", "oembed": "fresh" },
  "projection": { "profile": "fast", "hiddenFields": [] }
}

Provider-Native Preview

YouTube thumbnail is visible in FAST because it's provider-native. Generated preview enrichments (blurhash, palette) are omitted. The hiddenFields array is empty because provider-native preview is not hidden.

Infrastructure Documentation — Behavior-Driven, Schema-Governed