Anthropic (gateway)

1
{
2
  "mcpServers": {
3
    "respan-docs": {
4
      "url": "https://mcp.respan.ai/mcp/docs"
5
    }
6
  }
7
}

Use Respan Gateway to call Anthropic models while keeping unified observability (logs, cost, latency, and reliability metrics) in Respan.

Prerequisites

• A Respan API key
• Anthropic API key (BYOK)

Supported SDKs / integrations

Configuration

There are 2 ways to add your Anthropic credentials to your requests:

Via UI (Global)

1

Navigate to Providers

Go to the Providers page. This page allows you to manage credentials for supported model providers.

2

Add your Anthropic credentials

Select Anthropic and add the required credential fields.

• anthropic.api_key — your Anthropic API key

3

Configure Load Balancing (Optional)

Add multiple Anthropic credential sets for redundancy. Use the Load balancing weight field to control traffic distribution.

Via code (Per-Request)

You can pass credentials dynamically in the request body. This is useful if you need to use your users’ own API keys (BYOK).

Add the customer_credentials parameter to your Gateway request:

1
{
2
  "customer_credentials": {
3
    "anthropic": {
4
      "api_key": "YOUR_ANTHROPIC_API_KEY"
5
    }
6
  }
7
}

Override credentials for a particular model (Optional)

Use credential_override when one request or model should use different credentials than the default provider key.

1
{
2
  "customer_credentials": {
3
    "anthropic": {
4
      "api_key": "YOUR_ANTHROPIC_API_KEY"
5
    }
6
  },
7
  "credential_override": {
8
    "claude-3-5-sonnet-20240620": {
9
      "api_key": "ANOTHER_ANTHROPIC_API_KEY"
10
    }
11
  }
12
}

Supported models

Find the complete and current list of Anthropic model IDs on the Respan Models page. Use the exact model ID shown there in your gateway requests.

Log Anthropic requests

If you are not using the Gateway to proxy requests, you can still log your Anthropic requests to Respan asynchronously. This lets you track cost, latency, and performance metrics for external calls.

1
import requests
2
3
url = "https://api.respan.ai/api/request-logs/create/"
4
payload = {
5
  "model": "claude-3-5-sonnet-20240620",
6
  "prompt_messages": [
7
    {
8
      "role": "user",
9
      "content": "Hello, how are you?"
10
    }
11
  ],
12
  "completion_message": {
13
    "role": "assistant",
14
    "content": "Hello from Anthropic through Respan."
15
  },
16
  "cost": 0.001,
17
  "generation_time": 1.2,
18
  "customer_params": {
19
    "customer_identifier": "user_123"
20
  }
21
}
22
headers = {
23
    "Authorization": "Bearer YOUR_RESPAN_API_KEY",
24
    "Content-Type": "application/json",
25
}
26
27
response = requests.post(url, headers=headers, json=payload)