API reference

API reference · Public

A stored file, for a provider

GET/api/studio/signed/{parts}No key

One stored file for a provider to fetch while a job that starts from it runs: /api/studio/signed/{asset id}/{expires}/{signature}/{name}, made by the gateway when it sends a task (a lip sync, a restyle, an extension, an upscale) and given to nobody else. The link is the credential, signed with the server's key, and lapses after 30 minutes; with byte ranges, never cached. A wrong link is the same 404 as an unknown file; an expired one is 410 link_expired.

Parameters

Path and query parameters
FieldTypeWhat it is
parts (path)requiredstringThe asset id, the expiry, the signature and the file's name.

Answer 200

The file.

Answer 206

The requested bytes of the file.

Errors

  • 404OpenAI shaped error.
  • 410OpenAI shaped error.
  • 429OpenAI shaped error.
  • 502OpenAI 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
rangestringOne byte range, bytes=start-end.
Antimatter