TrustModel SDK API

Getting Started

1. Get Your API Key

Generate an API key from your TrustModel dashboard under Settings > API Keys.

2. Authenticate Requests

Include your API key in the X-API-Key header:

X-API-Key: tm-{env}-{key_id}_{secret}

Quick Example

Run an evaluation on a model:

curl -X POST /sdk/v1/evaluate/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_identifier": "gpt-4o",
    "evaluation_type": "quick-scan"
  }'

Get available model_identifier values from /sdk/v1/models/ and evaluation_type identifiers from /sdk/v1/evaluation-types/

Available Endpoints

GET /sdk/v1/config/

Get configuration options for evaluations

GET /sdk/v1/models/

List available AI models for evaluation

GET /sdk/v1/vendors/

List available vendors for custom endpoints

GET /sdk/v1/evaluation-types/

List evaluation types and their credit costs

POST /sdk/v1/validate-connection/

Test connection to a custom API endpoint

POST /sdk/v1/evaluate/

Create a new model evaluation

GET /sdk/v1/evaluations/

List your evaluations

GET /sdk/v1/evaluations/{id}/

Get evaluation details and results

GET /sdk/v1/evaluations/{id}/status/

Check evaluation status

GET /sdk/v1/credits/

Check your credit balance

Error Codes

api_key_inactive - API key is disabled or expired
api_key_credits_exhausted - API key credit limit reached
subscription_credits_exhausted - Subscription quota exceeded
insufficient_credits - Not enough credits for this operation