Get a file's content

GET/v1/files/{id}/content

Get a file's content.

Downloads the file's bytes (application/octet-stream). With a virtual key, only files uploaded with that key are returned (403 for another key's file); an unknown id is a 404.

Authenticate with a BYOK virtual key or with x-provider and x-api-key; a PLATFORM virtual key is a 400. OpenAI credentials only; any other provider is a 422.

Authorization

AuthorizationBearer <slug>.<secret>
A virtual key's API key (vk-....<secret>), as Authorization: Bearer. What the OpenAI SDK sends from its api_key. Used by the inference endpoints.
orx-virtual-keyheader
A virtual key's API key in the x-virtual-key header, for clients that keep Authorization for something else.
orx-api-keyheader
Direct credentials: the provider's own API key in x-api-key, with the provider named in x-provider (for example openai). On /v1/messages a virtual key is accepted in x-api-key too, which is what the Claude SDK sends.

Path parameters

idstringrequired
the file's VectorAxis id (vxf-...); the provider's file id is accepted too

Headers

x-providerstring
With direct credentials: the provider x-api-key belongs to, for example openai or anthropic (case and dashes are normalised). Not used with a virtual key.

Responses

200application/octet-stream

The file's bytes.

string<binary>

VectorAxis is built by GK Labs, a member of NVIDIA Inception.