Skip to content
Streamplace Logo Streamplace Docs

place.stream.playback.getVideoBlob

Lexicon Version: 1

Definitions

Section titled “Definitions”

main

Section titled “main”

Type: query

Fetch a content-addressed MUXL playback blob by CID. Serves either a primary fMP4 archive or a per-track init segment — both are CID-addressed and indistinguishable from the endpoint’s point of view. HTTP Range headers are honored; HLS media playlists generated by getVideoPlaylist reference this endpoint with EXT-X-BYTERANGE to serve segments out of the primary blob. The did identifies the owning account for egress accounting: the blob itself is content-addressed and owner-agnostic, so the caller carries the attribution.

Parameters:

NameTypeReq’dDescriptionConstraints
didstring✅DID of the account that owns the record this blob is being served for. Used for egress/usage accounting, not for access control — the blob is served purely by CID.Format: did
cidstring✅BLAKE-3 BDASL CID of the requested blob.
sidstring❌Opaque playback session identifier, propagated unmodified from the media playlist that referenced this blob. Logged for view-count correlation; not used for access control.

Output:

  • Encoding: video/mp4
  • Schema:

Schema not defined. Possible Errors:

  • BlobNotFound: This node doesn’t have the requested CID. The caller should consult place.stream.media.origin records to find a node that does.

Lexicon Source

Section titled “Lexicon Source”
{
  "lexicon": 1,
  "id": "place.stream.playback.getVideoBlob",
  "defs": {
    "main": {
      "type": "query",
      "description": "Fetch a content-addressed MUXL playback blob by CID. Serves either a primary fMP4 archive or a per-track init segment — both are CID-addressed and indistinguishable from the endpoint's point of view. HTTP `Range` headers are honored; HLS media playlists generated by getVideoPlaylist reference this endpoint with `EXT-X-BYTERANGE` to serve segments out of the primary blob. The `did` identifies the owning account for egress accounting: the blob itself is content-addressed and owner-agnostic, so the caller carries the attribution.",
      "parameters": {
        "type": "params",
        "required": ["did", "cid"],
        "properties": {
          "did": {
            "type": "string",
            "format": "did",
            "description": "DID of the account that owns the record this blob is being served for. Used for egress/usage accounting, not for access control — the blob is served purely by CID."
          },
          "cid": {
            "type": "string",
            "description": "BLAKE-3 BDASL CID of the requested blob."
          },
          "sid": {
            "type": "string",
            "description": "Opaque playback session identifier, propagated unmodified from the media playlist that referenced this blob. Logged for view-count correlation; not used for access control."
          }
        }
      },
      "output": {
        "encoding": "video/mp4"
      },
      "errors": [
        {
          "name": "BlobNotFound",
          "description": "This node doesn't have the requested CID. The caller should consult place.stream.media.origin records to find a node that does."
        }
      ]
    }
  }
}