Skip to main content
The evaluations API supports three model sources for both the judge and the models being evaluated: Together AI serverless models, your own dedicated model inference endpoints, and external provider models. Set the model_source field to choose between them.

Serverless models

Set model_source = "serverless" to use Together AI serverless inference. The evaluations service keeps its own allowlist of serverless models, separate from the full serverless catalog. The models below can serve as the judge or as the model being evaluated; this table syncs daily from the allowlist. Example configuration:
Python

Vision-capable models

To evaluate image inputs, use a serverless model that accepts images, such as the Qwen VL family. The evaluated model, and the judge if it should also see the image, must be vision-capable. Browse the serverless models catalog to find models that support vision, and see the evaluations page for how to add images to a dataset.

Dedicated models

To evaluate a model served on dedicated model inference, set model_source = "dedicated" and enter the endpoint ID (ep_abc123, from the deploy output or tg beta endpoints ls) in the model field. The endpoint must have a running deployment; requests fail with endpoint_not_ready while it is stopped. In the evaluations console, live dedicated model inference endpoints appear under My Endpoints in the model picker. Legacy dedicated endpoints appear under My Legacy Endpoints. Only endpoints with at least one live deployment are listed. Selecting an endpoint sets model_source to dedicated and uses the endpoint name as model. Example configuration:
Python

External models

Set model_source = "external" to use models from external providers.
External models require an API token from the provider. Set the external_api_token parameter with the provider’s API key.

Supported shortcuts

Use these shortcuts in the model field, and the API resolves the provider base URL automatically. Example configuration with a shortcut:
Python

Custom base URL

To use any OpenAI chat/completions-compatible API, specify a custom external_base_url:
Python
The external API must be OpenAI chat/completions-compatible.