API reference

API reference · API

A stored file's bytes

GET/v1/studio/assets/{id}/contentAPI key

Served by this door only, private, never kept by a shared cache, with nosniff; a Range header is answered 206 and one past the end 416. A 404 with code storage_off while stored media is switched off (ANTIMATTER_STUDIO_STORAGE). An API key with the read scope. Rate limited per key at the key's own requests a minute, in a window of its own. An agent's key is refused (403 policy_violation). Every /v1/studio door is a 404 while video and sound jobs are switched off.

Parameters

Path and query parameters
FieldTypeWhat it is
id (path)requiredstringThe stored file's id, sa_ followed by hex.

Answer 200

The file.

Answer 206

Part of the file.

Errors

  • 401OpenAI shaped error.
  • 403OpenAI shaped error.
  • 404OpenAI shaped error.
  • 409OpenAI shaped error.
  • 416OpenAI shaped error.
  • 429OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Request headers it reads (1)
Request headers
FieldTypeWhat it is
Rangestring
Antimatter