DocsAPI Reference
API Guides

Images and files

Send media in the format supported by your selected model.


Choose a model that supports the media you want to send. Support for images, documents, audio and other input types depends on the model, provider and endpoint.

Choose an input format

InputWhat to check
Hosted URLThe provider can fetch it and supports that resource type
Inline content or data URLThe selected endpoint accepts that format and size
Provider file IDThe provider supports file input and recognizes that ID

Chat Completions, Responses and Anthropic Messages use different content structures. Follow the format for your selected endpoint; changing the base URL does not convert media schemas.

Use a hosted resource

Host the resource where the provider can access it, then include its URL in the model's supported media-input structure.

A localhost URL is not reachable by an external provider. An authenticated download link is also not accessible just because your model request includes a Tokamak key.

Files and storage

A file upload does not prove that a model can read it. Tokamak's optional media endpoints are storage helpers, not a complete provider Files API.

For a first integration, start with text in the Quickstart, then add a media type supported by your model.

On this page