Back to Mastra

Helicone | Models

docs/src/content/en/models/providers/helicone.mdx

2025-12-1826.2 KB
Original Source

Helicone

Access 91 Helicone models through Mastra's model router. Authentication is handled automatically using the HELICONE_API_KEY environment variable.

Learn more in the Helicone documentation.

bash
HELICONE_API_KEY=your-api-key
typescript
import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "helicone/chatgpt-4o-latest"
});

// Generate a response
const response = await agent.generate("Hello!");

// Stream a response
const stream = await agent.stream("Tell me a story");
for await (const chunk of stream) {
  console.log(chunk);
}

:::info

Mastra uses the OpenAI-compatible /chat/completions endpoint. Some provider-specific features may not be available. Check the Helicone documentation for details.

:::

Models

<ProviderModelsTable models={[ { "model": "helicone/chatgpt-4o-latest", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 16384, "inputCost": 5, "outputCost": 20 }, { "model": "helicone/claude-3-haiku-20240307", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 4096, "inputCost": 0.25, "outputCost": 1.25 }, { "model": "helicone/claude-3.5-haiku", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 8192, "inputCost": 0.7999999999999999, "outputCost": 4 }, { "model": "helicone/claude-3.5-sonnet-v2", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 8192, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/claude-3.7-sonnet", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 64000, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/claude-4.5-haiku", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 8192, "inputCost": 1, "outputCost": 5 }, { "model": "helicone/claude-4.5-opus", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 64000, "inputCost": 5, "outputCost": 25 }, { "model": "helicone/claude-4.5-sonnet", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 64000, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/claude-haiku-4-5-20251001", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 8192, "inputCost": 1, "outputCost": 5 }, { "model": "helicone/claude-opus-4", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 32000, "inputCost": 15, "outputCost": 75 }, { "model": "helicone/claude-opus-4-1", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 32000, "inputCost": 15, "outputCost": 75 }, { "model": "helicone/claude-opus-4-1-20250805", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 32000, "inputCost": 15, "outputCost": 75 }, { "model": "helicone/claude-sonnet-4", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 64000, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/claude-sonnet-4-5-20250929", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 200000, "maxOutput": 64000, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/codex-mini-latest", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 100000, "inputCost": 1.5, "outputCost": 6 }, { "model": "helicone/deepseek-r1-distill-llama-70b", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 128000, "maxOutput": 4096, "inputCost": 0.03, "outputCost": 0.13 }, { "model": "helicone/deepseek-reasoner", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 128000, "maxOutput": 64000, "inputCost": 0.56, "outputCost": 1.68 }, { "model": "helicone/deepseek-tng-r1t2-chimera", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 130000, "maxOutput": 163840, "inputCost": 0.3, "outputCost": 1.2 }, { "model": "helicone/deepseek-v3", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 8192, "inputCost": 0.56, "outputCost": 1.68 }, { "model": "helicone/deepseek-v3.1-terminus", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 128000, "maxOutput": 16384, "inputCost": 0.27, "outputCost": 1 }, { "model": "helicone/deepseek-v3.2", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 163840, "maxOutput": 65536, "inputCost": 0.27, "outputCost": 0.41 }, { "model": "helicone/ernie-4.5-21b-a3b-thinking", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": true, "contextWindow": 128000, "maxOutput": 8000, "inputCost": 0.07, "outputCost": 0.28 }, { "model": "helicone/gemini-2.5-flash", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 1048576, "maxOutput": 65535, "inputCost": 0.3, "outputCost": 2.5 }, { "model": "helicone/gemini-2.5-flash-lite", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 1048576, "maxOutput": 65535, "inputCost": 0.09999999999999999, "outputCost": 0.39999999999999997 }, { "model": "helicone/gemini-2.5-pro", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 1048576, "maxOutput": 65536, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gemini-3-pro-preview", "imageInput": true, "audioInput": true, "videoInput": true, "toolUsage": true, "reasoning": true, "contextWindow": 1048576, "maxOutput": 65536, "inputCost": 2, "outputCost": 12 }, { "model": "helicone/gemma-3-12b-it", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 131072, "maxOutput": 8192, "inputCost": 0.049999999999999996, "outputCost": 0.09999999999999999 }, { "model": "helicone/gemma2-9b-it", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 8192, "maxOutput": 8192, "inputCost": 0.01, "outputCost": 0.03 }, { "model": "helicone/glm-4.6", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 204800, "maxOutput": 131072, "inputCost": 0.44999999999999996, "outputCost": 1.5 }, { "model": "helicone/gpt-4.1", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 1047576, "maxOutput": 32768, "inputCost": 2, "outputCost": 8 }, { "model": "helicone/gpt-4.1-mini", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 1047576, "maxOutput": 32768, "inputCost": 0.39999999999999997, "outputCost": 1.5999999999999999 }, { "model": "helicone/gpt-4.1-mini-2025-04-14", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 1047576, "maxOutput": 32768, "inputCost": 0.39999999999999997, "outputCost": 1.5999999999999999 }, { "model": "helicone/gpt-4.1-nano", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 1047576, "maxOutput": 32768, "inputCost": 0.09999999999999999, "outputCost": 0.39999999999999997 }, { "model": "helicone/gpt-4o", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 16384, "inputCost": 2.5, "outputCost": 10 }, { "model": "helicone/gpt-4o-mini", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 16384, "inputCost": 0.15, "outputCost": 0.6 }, { "model": "helicone/gpt-5", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gpt-5-chat-latest", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 16384, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gpt-5-codex", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gpt-5-mini", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 0.25, "outputCost": 2 }, { "model": "helicone/gpt-5-nano", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 0.049999999999999996, "outputCost": 0.39999999999999997 }, { "model": "helicone/gpt-5-pro", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 128000, "maxOutput": 32768, "inputCost": 15, "outputCost": 120 }, { "model": "helicone/gpt-5.1", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gpt-5.1-chat-latest", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 16384, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gpt-5.1-codex", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 1.25, "outputCost": 10 }, { "model": "helicone/gpt-5.1-codex-mini", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 400000, "maxOutput": 128000, "inputCost": 0.25, "outputCost": 2 }, { "model": "helicone/gpt-oss-120b", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 131072, "maxOutput": 131072, "inputCost": 0.04, "outputCost": 0.16 }, { "model": "helicone/gpt-oss-20b", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 131072, "maxOutput": 131072, "inputCost": 0.049999999999999996, "outputCost": 0.19999999999999998 }, { "model": "helicone/grok-3", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 131072, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/grok-3-mini", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 131072, "inputCost": 0.3, "outputCost": 0.5 }, { "model": "helicone/grok-4", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 256000, "maxOutput": 256000, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/grok-4-1-fast-non-reasoning", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 2000000, "maxOutput": 30000, "inputCost": 0.19999999999999998, "outputCost": 0.5 }, { "model": "helicone/grok-4-1-fast-reasoning", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 2000000, "maxOutput": 2000000, "inputCost": 0.19999999999999998, "outputCost": 0.5 }, { "model": "helicone/grok-4-fast-non-reasoning", "imageInput": true, "audioInput": true, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 2000000, "maxOutput": 2000000, "inputCost": 0.19999999999999998, "outputCost": 0.5 }, { "model": "helicone/grok-4-fast-reasoning", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 2000000, "maxOutput": 2000000, "inputCost": 0.19999999999999998, "outputCost": 0.5 }, { "model": "helicone/grok-code-fast-1", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 256000, "maxOutput": 10000, "inputCost": 0.19999999999999998, "outputCost": 1.5 }, { "model": "helicone/hermes-2-pro-llama-3-8b", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 131072, "inputCost": 0.14, "outputCost": 0.14 }, { "model": "helicone/kimi-k2-0711", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 16384, "inputCost": 0.5700000000000001, "outputCost": 2.3 }, { "model": "helicone/kimi-k2-0905", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 262144, "maxOutput": 16384, "inputCost": 0.5, "outputCost": 2 }, { "model": "helicone/kimi-k2-thinking", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 256000, "maxOutput": 262144, "inputCost": 0.48, "outputCost": 2 }, { "model": "helicone/llama-3.1-8b-instant", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 32678, "inputCost": 0.049999999999999996, "outputCost": 0.08 }, { "model": "helicone/llama-3.1-8b-instruct", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 16384, "maxOutput": 16384, "inputCost": 0.02, "outputCost": 0.049999999999999996 }, { "model": "helicone/llama-3.1-8b-instruct-turbo", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 128000, "inputCost": 0.02, "outputCost": 0.03 }, { "model": "helicone/llama-3.3-70b-instruct", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 16400, "inputCost": 0.13, "outputCost": 0.39 }, { "model": "helicone/llama-3.3-70b-versatile", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 32678, "inputCost": 0.59, "outputCost": 0.7899999999999999 }, { "model": "helicone/llama-4-maverick", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 8192, "inputCost": 0.15, "outputCost": 0.6 }, { "model": "helicone/llama-4-scout", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 131072, "maxOutput": 8192, "inputCost": 0.08, "outputCost": 0.3 }, { "model": "helicone/llama-guard-4", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 131072, "maxOutput": 1024, "inputCost": 0.21, "outputCost": 0.21 }, { "model": "helicone/llama-prompt-guard-2-22m", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 512, "maxOutput": 2, "inputCost": 0.01, "outputCost": 0.01 }, { "model": "helicone/llama-prompt-guard-2-86m", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 512, "maxOutput": 2, "inputCost": 0.01, "outputCost": 0.01 }, { "model": "helicone/mistral-large-2411", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 32768, "inputCost": 2, "outputCost": 6 }, { "model": "helicone/mistral-nemo", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 128000, "maxOutput": 16400, "inputCost": 20, "outputCost": 40 }, { "model": "helicone/mistral-small", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 128000, "maxOutput": 128000, "inputCost": 75, "outputCost": 200 }, { "model": "helicone/o1", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 200000, "maxOutput": 100000, "inputCost": 15, "outputCost": 60 }, { "model": "helicone/o1-mini", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 128000, "maxOutput": 65536, "inputCost": 1.1, "outputCost": 4.4 }, { "model": "helicone/o3", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 100000, "inputCost": 2, "outputCost": 8 }, { "model": "helicone/o3-mini", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 100000, "inputCost": 1.1, "outputCost": 4.4 }, { "model": "helicone/o3-pro", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 100000, "inputCost": 20, "outputCost": 80 }, { "model": "helicone/o4-mini", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 200000, "maxOutput": 100000, "inputCost": 1.1, "outputCost": 4.4 }, { "model": "helicone/qwen2.5-coder-7b-fast", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 32000, "maxOutput": 8192, "inputCost": 0.03, "outputCost": 0.09 }, { "model": "helicone/qwen3-235b-a22b-thinking", "imageInput": true, "audioInput": false, "videoInput": true, "toolUsage": false, "reasoning": true, "contextWindow": 262144, "maxOutput": 81920, "inputCost": 0.3, "outputCost": 2.9000000000000004 }, { "model": "helicone/qwen3-30b-a3b", "imageInput": true, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 41000, "maxOutput": 41000, "inputCost": 0.08, "outputCost": 0.29 }, { "model": "helicone/qwen3-32b", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 131072, "maxOutput": 40960, "inputCost": 0.29, "outputCost": 0.59 }, { "model": "helicone/qwen3-coder", "imageInput": true, "audioInput": true, "videoInput": true, "toolUsage": true, "reasoning": false, "contextWindow": 262144, "maxOutput": 16384, "inputCost": 0.22, "outputCost": 0.95 }, { "model": "helicone/qwen3-coder-30b-a3b-instruct", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 262144, "maxOutput": 262144, "inputCost": 0.09999999999999999, "outputCost": 0.3 }, { "model": "helicone/qwen3-next-80b-a3b-instruct", "imageInput": true, "audioInput": false, "videoInput": true, "toolUsage": true, "reasoning": false, "contextWindow": 262000, "maxOutput": 16384, "inputCost": 0.14, "outputCost": 1.4 }, { "model": "helicone/qwen3-vl-235b-a22b-instruct", "imageInput": true, "audioInput": false, "videoInput": true, "toolUsage": true, "reasoning": false, "contextWindow": 256000, "maxOutput": 16384, "inputCost": 0.3, "outputCost": 1.5 }, { "model": "helicone/sonar", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 127000, "maxOutput": 4096, "inputCost": 1, "outputCost": 1 }, { "model": "helicone/sonar-deep-research", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": true, "contextWindow": 127000, "maxOutput": 4096, "inputCost": 2, "outputCost": 8 }, { "model": "helicone/sonar-pro", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": false, "contextWindow": 200000, "maxOutput": 4096, "inputCost": 3, "outputCost": 15 }, { "model": "helicone/sonar-reasoning", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": true, "contextWindow": 127000, "maxOutput": 4096, "inputCost": 1, "outputCost": 5 }, { "model": "helicone/sonar-reasoning-pro", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": false, "reasoning": true, "contextWindow": 127000, "maxOutput": 4096, "inputCost": 2, "outputCost": 8 } ]} />

Advanced configuration

Custom headers

typescript
const agent = new Agent({
  id: "custom-agent",
  name: "custom-agent",
  model: {
    url: "https://ai-gateway.helicone.ai/v1",
    id: "helicone/chatgpt-4o-latest",
    apiKey: process.env.HELICONE_API_KEY,
    headers: {
      "X-Custom-Header": "value"
    }
  }
});

Dynamic model selection

typescript
const agent = new Agent({
  id: "dynamic-agent",
  name: "Dynamic Agent",
  model: ({ requestContext }) => {
    const useAdvanced = requestContext.task === "complex";
    return useAdvanced
      ? "helicone/sonar-reasoning-pro"
      : "helicone/chatgpt-4o-latest";
  }
});