media

Get a media item by id

Required permission: media:read

get/v1/media/{id}

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/media/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: media:read)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required

Query parameters

projectIdstring

Response

Media item.

idstring required
statusstring required
source'upload' | 'generated' | 'stock' required
namestring required
mimeTypestring required
fileSizenumber required
durationnumber nullable required
widthnumber nullable required
heightnumber nullable required
frameRatenumber nullable required
analysisobject nullable required
listUsdnumber

A2 money stamp — GENERATED media only: the generate meter's LIST price (USD) at the success terminal. A plan allowance may zero the invoice line. Absent for uploads/imports, failures, x402 (on-chain receipts).

thumbnailUrlstring nullable required

Presigned GET URL for the item's thumbnail (an uploaded image is its own thumbnail), valid ~7 days — fetch it directly, no auth header. null when no thumbnail exists yet (still processing, stock imports, audio).

kindstring nullable required
tagsstring[] nullable required
createdAtstring required
updatedAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.