> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Download frame-accurate scene media for this document. > Export this scene's media cut frame-accurately to its time range. The document's ``video_segment_url`` serves the extraction-time clip, which is stream-copied and therefore keyframe-bounded — it can overshoot ``[start_time, end_time]`` by up to a GOP (~1s). This endpoint re-cuts from the ORIGINAL source with re-encode so the exported media matches the declared range within one source frame, caches the result beside the extraction clip, and returns a presigned download URL. The first call for a given range pays the re-encode (seconds, bounded); repeat calls serve the cache. ## OpenAPI ````yaml get /v1/collections/{collection_identifier}/documents/{document_id}/download openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: - BearerAuth: [] paths: /v1/collections/{collection_identifier}/documents/{document_id}/download: get: tags: - Collection Documents summary: Download frame-accurate scene media for this document. description: >- Export this scene's media cut frame-accurately to its time range. The document's ``video_segment_url`` serves the extraction-time clip, which is stream-copied and therefore keyframe-bounded — it can overshoot ``[start_time, end_time]`` by up to a GOP (~1s). This endpoint re-cuts from the ORIGINAL source with re-encode so the exported media matches the declared range within one source frame, caches the result beside the extraction clip, and returns a presigned download URL. The first call for a given range pays the re-encode (seconds, bounded); repeat calls serve the cache. operationId: >- download_document_media_v1_collections__collection_identifier__documents__document_id__download_get parameters: - name: collection_identifier in: path required: true schema: type: string description: The ID or name of the collection. title: Collection Identifier description: The ID or name of the collection. - name: document_id in: path required: true schema: type: string description: The ID of the scene document. title: Document Id description: The ID of the scene document. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SceneDownloadResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] NamespaceHeader: [] components: schemas: SceneDownloadResponse: properties: download_url: type: string title: Download Url description: Presigned URL for the frame-accurate media cut. cached: type: boolean title: Cached description: Whether the cut was served from cache. start_time: type: number title: Start Time description: Scene start time in seconds. end_time: type: number title: End Time description: Scene end time in seconds. type: object required: - download_url - cached - start_time - end_time title: SceneDownloadResponse ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: >- Mixpeek API key, sent as `Authorization: Bearer mxp_sk_...`. Create one in Studio under Settings → API Keys, or with an admin key via `POST /v1/organizations/users/{user_email}/api-keys`. A missing header returns 403; an invalid or revoked key returns 401. NamespaceHeader: type: apiKey in: header name: X-Namespace description: >- Namespace id (`ns_...`), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked `x-mixpeek-namespace-scoped`. ````