API reference

API reference · Account

What each film keeps in stored media, and what a day of it costs

GET/api/studio/storage/filmsSigned in session

Every stored file counted once by its stored bytes, under the one use that keeps it: the newest film that names it, a character, a live public link, a film that exists and this person no longer reaches, made in the last 24 hours, or unused. Each film's day price is its own bytes at the operator's price per GB (10^9 bytes) a day, before the free bytes; 0 is free. The unused files are listed largest first, at most 500, and every id is named. A 404 with code storage_off while the operator keeps no files for the studio. The signed in account; same origin for a write.

Answer 200

The breakdown.

Fields of the 200 answer
FieldTypeWhat it is
object"studio.storage.films"
bytesinteger
filesinteger
max_bytesinteger
price_micros_per_gb_dayinteger
free_bytesinteger
day_microsinteger
unpaidstring or null
grace_hoursinteger
filmsarray of object
films[].project_idstring
films[].namestring
films[].bytesinteger
films[].filesinteger
films[].day_microsinteger
charactersobject
characters.bytesinteger
characters.filesinteger
characters.day_microsinteger
linksobject
links.bytesinteger
links.filesinteger
links.day_microsinteger
elsewhereobject
elsewhere.bytesinteger
elsewhere.filesinteger
elsewhere.day_microsinteger
recentobject
recent.bytesinteger
recent.filesinteger
recent.day_microsinteger
unusedobject
unused.bytesinteger
unused.filesinteger
unused.day_microsinteger
unused.idsarray of string
unused.dataarray of object
unused.data[].idstring
unused.data[].namestring or null
unused.data[].wordsstring or nullThe words a take was made from, when it has no name.
unused.data[].kindstringOne of "picture", "audio", "clip".
unused.data[].bytesinteger
unused.data[].filmstring or null
unused.data[].created_atinteger

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 403OpenAI shaped error.
  • 404OpenAI 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.

Antimatter