Get library media
get_library_mediaUse after get_library_file when you need authorized binary bytes for an uploaded image, audio, or video.
When to use it
Use after get_library_file when you need authorized binary bytes for an uploaded image, audio, or video. Request offset ranges for larger videos and pass the latest expectedUpdatedAt when continuing after the first range.
Search chunks, read only the precise chunk or bounded text needed, cite ids.
Source text, chunks, snippets, ids, and citation-ready context.
Avoid using it when
Do not use for text extraction, YouTube transcript retrieval, or arbitrary remote URLs. Respect the returned delivery mode and host payload limits.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Retrieve complete bounded base64 bytes for an owned private image or audio source, or a verified byte range for a large video or audio source. Oversized responses are rejected instead of silently truncated. Use when: Use after get_library_file when you need authorized binary bytes for an uploaded image, audio, or video. Request offset ranges for larger videos and pass the latest expectedUpdate... Avoid when: Do not use for text extraction, YouTube transcript retrieval, or arbitrary remote URLs. Respect the returned delivery mode and host payload limits.
View JSON Schema
{
"type": "object",
"properties": {
"fileId": {
"type": "string",
"format": "uuid"
},
"maxBytes": {
"type": "integer",
"minimum": 1,
"maximum": 8388608,
"default": 2097152
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Byte offset for a video continuation range. Start at 0 for the first segment."
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"description": "Required for offset > 0; use updatedAt from the latest get_library_file response."
}
},
"required": [
"fileId"
],
"additionalProperties": false
}