- Access 300+ models from OpenAI, Anthropic, Google, Meta, Mistral, Cohere, and many other providers through one API key.
- Generate images from text prompts, in any workflow or as an AI Agent tool.
- Enforce strict JSON Schema server side for real structured output, not prompt engineered.
- Give the model a native web search tool for up to date information.
- Tune reasoning effort for reasoning capable models.
- Apply fallback policies, load balancing, and latency routing to keep your workflows responsive.
- Track and manage your spend in a single location.
Prerequisites
- A running n8n instance (Cloud or self hosted).
- A Requesty API key from the API Keys page.
Installation
Follow the community nodes installation guide in the n8n documentation. In your n8n instance, go to Settings > Community Nodes and install:Credentials
- Sign up at app.requesty.ai.
- Generate an API key on the API Keys page.
- In n8n, create a new Requesty API credential and paste your key.
Usage
Chat models
The Requesty Chat Model node connects to any model available through Requesty’s unified gateway. Use it anywhere n8n accepts a chat model, such as the AI Agent node, Basic LLM Chain, or any AI workflow. Once your API key is saved, the Model dropdown auto populates with all available models. You can also set a model ID directly using an expression, for exampleanthropic/claude-sonnet-4-6 or openai/gpt-5.4. To route through a policy, use the policy/policy-name format such as policy/reliable-coding. See Routing Policies for how to create a policy that automatically falls back between models.
Configuration options
| Option | Default | Description |
|---|---|---|
| Response Format | Text | Text, JSON Object, or JSON Schema (strict structured output) |
| JSON Schema | (example) | The schema the response must match when Response Format is JSON Schema |
| Reasoning Effort | Default | Reasoning level (low, medium, high) for reasoning capable models |
| Base URL | (gateway) | Override the gateway URL for self hosted Requesty deployments |
| Enable Web Search | off | Give the model a native web search tool for up to date information |
| Web Search Context Size | medium | How much context the web search retrieves per query |
| Sampling Temperature | 0.7 | Controls randomness (0 is deterministic, 2 is very random) |
| Maximum Tokens | unlimited | Maximum number of tokens to generate |
| Top P | 1 | Nucleus sampling probability mass |
| Frequency Penalty | 0 | Penalizes token repetition |
| Presence Penalty | 0 | Penalizes already seen tokens |
Image generation
The Requesty Image Generation node turns a text prompt into an image using models available through the gateway, such asazure/openai/gpt-image-1. Use it as a regular node in any workflow, or attach it to an AI Agent as a tool.
By default the node outputs binary image data, so you get a preview right in the n8n output panel and can pass the image to downstream nodes like Write Binary File or HTTP Request. Enable Return Image URLs to receive URLs in the JSON output instead.
Configuration options
| Option | Default | Description |
|---|---|---|
| Model | azure/openai/gpt-image-1 | The model to use for image generation |
| Prompt | (required) | A text description of the desired image |
| Size | 1024x1024 | Image dimensions: 1024x1024, 1536x1024, or 1024x1536 |
| Quality | auto | Image quality: auto, high, medium, or low |
| Number of Images | 1 | How many images to generate (1 to 10) |
| Background | auto | Background type: auto, transparent, or opaque |
| Output Format | png | File format: png, jpeg, or webp |
| Return Image URLs | off | Return URLs instead of binary image data |
| Base URL | (gateway) | Override the gateway URL for self hosted deployments |
| Custom Headers | (none) | Extra HTTP headers for tagging and tracking |
Using image generation as an AI Agent tool
The node can act as a tool that an AI Agent calls on its own when a user asks for an image:- Set the environment variable
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=trueon your n8n instance. - Add the Requesty Image Generation node to your workflow.
- Connect it to the AI Agent’s Tools input.
- The agent decides when to generate images and writes the prompt itself.
Key features
- 300+ models: Access models from OpenAI, Anthropic, Google, Meta, Mistral, Cohere, and more.
- Image generation: Create images from text prompts, in workflows or as an AI Agent tool.
- Responses API: Built on the Responses API, unlocking richer capabilities than plain chat completions.
- Structured output: Enforce a strict JSON Schema server side (structured outputs).
- Native web search: Let the model search the web for current information (web search).
- Reasoning control: Tune reasoning effort for reasoning capable models (reasoning).
- Intelligent routing: Automatic fallbacks and load balancing across providers.
- Self hosted friendly: Point the nodes at your own Requesty deployment via the Base URL option.