Bluwing picks the right tools for a request, in the right order, and fills in their arguments from what the user said. You pass your prompt and the tool definitions your agent already has. It gives back deterministic, execution-ready calls.
It replaces the brute-force step where you send dozens or hundreds of tool definitions into an LLM context window on every conversational turn. A call to Bluwing takes tens of milliseconds (18–35 ms), costs $0.015 per 1,000,000 input tokens (output tokens are 100% free), and never hallucinates an argument the user didn't provide.
How It Works in Your Architecture
Your agent keeps doing everything it does today. Only the tool-selection step moves to Bluwing:
User speaks or sends text to your application
Evaluates prompt and tools using model: "bluwing"
Traverses compiled tree in sub-milliseconds (<35ms)
Returns structured JSON with confidence, arguments, and grounding
Runs the chosen functions with your own credentials and databases
- User Request: A user talks to your app or agent.
- Unified Call: Your server sends the user's text and tool array to
POST /v1/chat/completionswithmodel: "bluwing". - Deterministic Choice: Bluwing evaluates the request against your tool index (matching existing bricks or compiling JIT on the fly) and returns:
tool_calls: The exact tools to execute with arguments extracted and grounded in the prompt.needs_input: A clarifying question because a required argument is missing.no_tool: Fast deadband response when the request is general conversation or out-of-scope.- Execution: Your backend executes the returned calls with your existing API keys, databases, or microservices.
Core Concepts
| Piece | What it is |
|---|---|
| Tool | A standard function definition: name, description, and JSON Schema parameters. Identical to OpenAI and Anthropic tool formats. |
Model (bluwing) | The unified routing model. Automatically resolves tools against ready bricks or compiles ephemeral bricks on the fly. |
| Toolset (Brick) | A collection of tools compiled into an optimized high-dimensional vector search index. |
| Dynamic Masking | Passing a subset of tools runs on the parent brick with 0ms compilation delay while masking non-passed tools. |
| Tokens & Metering | Billed at $0.015 per 1,000,000 input tokens. Output tokens are completely free. |
What You Need to Get Started
- An Account: Sign up at bluwing.si to receive 5,000,000 Free Tier tokens immediately.
- Your API Key: Created on the API Keys page. Store it securely in your backend environment variables (
BLUWING_API_KEY). - Your Tool Definitions: Ordinary JSON Schemas you already use with OpenAI, Anthropic, or LangChain.
The API runs at https://api.bluwing.si. Head to the Quickstart to make your first live call in under five minutes.