Body Builder

The Body Builder (openrouter/bodybuilder) transforms natural language prompts into structured OpenRouter API requests, enabling you to easily run the same task across multiple models in parallel.

Overview

Body Builder uses AI to understand your intent and generate valid OpenRouter API request bodies. Simply describe what you want to accomplish and which models you want to use, and Body Builder returns ready-to-execute JSON requests.

Usage

1
import { OpenRouter } from '@openrouter/sdk';
2
3
const openRouter = new OpenRouter({
4
  apiKey: '<OPENROUTER_API_KEY>',
5
});
6
7
const completion = await openRouter.chat.send({
8
  model: 'openrouter/bodybuilder',
9
  messages: [
10
    {
11
      role: 'user',
12
      content: 'Count to 10 using Claude Sonnet and GPT-5',
13
    },
14
  ],
15
});
16
17
// Parse the generated requests
18
const generatedRequests = JSON.parse(completion.choices[0].message.content);
19
console.log(generatedRequests);

Response Format

Body Builder returns a JSON object containing an array of OpenRouter-compatible request bodies:

1
{
2
  "requests": [
3
    {
4
      "model": "anthropic/claude-sonnet-4.5",
5
      "messages": [
6
        {"role": "user", "content": "Count to 10"}
7
      ]
8
    },
9
    {
10
      "model": "openai/gpt-5.1",
11
      "messages": [
12
        {"role": "user", "content": "Count to 10"}
13
      ]
14
    }
15
  ]
16
}

Executing Generated Requests

After generating the request bodies, execute them in parallel:

1
// Generate the requests
2
const builderResponse = await openRouter.chat.send({
3
  model: 'openrouter/bodybuilder',
4
  messages: [{ role: 'user', content: 'Explain gravity using Gemini and Claude' }],
5
});
6
7
const { requests } = JSON.parse(builderResponse.choices[0].message.content);
8
9
// Execute all requests in parallel
10
const results = await Promise.all(
11
  requests.map((req) => openRouter.chat.send(req))
12
);
13
14
// Process results
15
results.forEach((result, i) => {
16
  console.log(`Model: ${requests[i].model}`);
17
  console.log(`Response: ${result.choices[0].message.content}\n`);
18
});

Use Cases

Model Benchmarking

Compare how different models handle the same task:

"Write a haiku about programming using Claude Sonnet, GPT-5, and Gemini"

Redundancy and Reliability

Get responses from multiple providers for critical applications:

"Answer 'What is 2+2?' using three different models for verification"

A/B Testing

Test prompts across models to find the best fit:

"Summarize this article using the top 5 coding models: [article text]"

Exploration

Discover which models excel at specific tasks:

"Generate a creative story opening using various creative writing models"

Model Selection

Body Builder has access to all available OpenRouter models and will:

• Use the latest model versions by default
• Select appropriate models based on your description
• Understand model aliases and common names

Example model references that work:

• “Claude Sonnet” → anthropic/claude-sonnet-4.5
• “Claude Opus” → anthropic/claude-opus-4.5
• “GPT-5” → openai/gpt-5.1
• “Gemini” → google/gemini-3.1-pro-preview
• “DeepSeek” → deepseek/deepseek-v3.2

Pricing

• Body Builder requests: Free (no charge for generating request bodies)
• Executing generated requests: Standard model pricing applies

Limitations

• Requires messages format input
• Generated requests use minimal required fields by default
• System messages in your input are preserved and forwarded

Related

• Auto Router - Automatic single-model selection
• Model Fallbacks - Configure fallback models
• Structured Outputs - Get structured JSON responses