Overview
The Text Generation Node enables users to automatically generate text or structured data using advanced AI models. This node can be used for a wide range of purposes — such as creating summaries, generating responses, writing articles, or producing structured JSON data — without requiring any coding knowledge. It forms a key component in workflows where natural language generation or intelligent content creation is required.Description
This node uses AI models (e.g.,aicon-v4-nano-160824, aicon-v4-large-160824, aicon-v4-search-160824) to process user instructions and produce text or JSON output.
It is fully compatible with no-code workflows, meaning users can simply configure key parameters through an intuitive interface without writing scripts or API calls.
Input Parameters
The node accepts a flat list of key-value inputs. Each parameter controls specific aspects of how the AI generates content.-
generationType
Defines which AI model to use.
Choose from:
aicon-v4-nano-160824– for simple or lightweight tasks.aicon-v4-large-160824– for complex text generation or file-based processing.aicon-v4-search-160824– for search, analysis, and summarization tasks.
- prompt / question The main instruction or query you want the AI to respond to. Example: Write a 100-word summary about renewable energy.
- trainingData Helps define the AI’s behavior, tone, and role, ensuring its responses are structured and aligned with the intended purpose. Also referred to as the “system prompt.”
-
attachments
Comma-separated list of file IDs that the AI can analyze or reference.
Works only with
aicon-v4-large-160824. - randomness Controls creativity on a scale from 0 to 1. Lower values generate predictable, factual responses. Higher values produce more creative and diverse outputs.
-
outputType
Defines how the output is formatted:
"text"– for plain written responses."json"– for structured, machine-readable data.
-
thinking
When set to
"true", the AI performs deeper reasoning before generating results. - conversationId Maintains context across multiple runs, allowing the AI to remember previous interactions and produce consistent responses.
-
jsonContent
Required only when
outputTypeis"json". Defines the structure of the expected JSON output. Must be flat, without nested objects or arrays. Example:
Important: When creating JSON schemas, always use flat structures. Avoid nested objects and arrays. Use numbered keys instead of arrays (e.g.,Access values from this node using:"item1","item2").
Here’s your Output Parameters section rewritten from the table into clear bullet points in Markdown — consistent with your input section style and suitable for documentation:
Output Parameters
After execution, the node returns several outputs that represent both the AI’s result and processing information.- processingCount Indicates the total number of tokens or data units processed by the AI model during execution.
- processingTime Total time taken to generate the response, returned as a number (milliseconds).
- processingId A unique identifier automatically assigned to each generation request. Useful for debugging or tracking specific executions.
- conversationId Identifier used to maintain continuity between multiple AI generations. When reused, it allows the AI to remember previous context and respond consistently.
-
content
The main output generated by the AI.
- If
outputTypeis"text", this contains the generated text. - If
outputTypeis"json", it follows the user-defined schema from thejsonContentinput.
- If
Output Type
The node’s outputType determines what thecontent field contains:
"text"→ Regular AI-generated text output."json"→ Structured data matching the definedjsonContentschema.
Example Usage
1. Generate Text
Goal: Write a paragraph about AI ethics. Input Configuration:2. Generate Structured JSON
Goal: Extract key points from an article. Input Configuration:How to Use in a No-Code Workflow
- Add the Node: Drag the Text Generation Node into your workflow builder.
- Connect a Trigger: For example, use an Email Trigger or REST API Trigger.
- Configure Inputs: Enter your prompt, choose the AI model, and select the output type.
- Link Outputs: Connect this node’s
contentoutput to the next step — e.g., a Text-to-Speech Node, Slack Message Node, or Document Writer Node. - Run the Workflow: The node will automatically generate text or structured data as defined.
Best Practices
- Keep prompts specific and concise for more accurate AI results.
- Use flat JSON structures to simplify integration with downstream nodes.
- For complex file-based tasks, select
aicon-v4-large-160824. - To maintain conversational context (like a chatbot), pass a consistent
conversationId. - Use
randomnessbetween 0.2 and 0.5 for balanced creativity and coherence.
Example Workflow Integration
Workflow: “Generate and Send AI-Generated Report”- Trigger Node: REST API (to receive input data)
- AI Node: Text Generation Node (to create the report)
- Process Node: Return State Node (to display the desired output)
Common Errors
Below are common errors that may occur while using the Text Generation node, along with their causes and suggested resolutions.-
Missing required parameter
Cause: Either
promptorgenerationTypewas not provided in the input. Resolution: Make sure bothpromptandgenerationTypeare included before running the node. - Unauthorized Cause: Invalid or missing API credentials. Resolution: Check your API key or authentication settings and ensure the account has permission to access the AI model.
- Invalid JSON structure Cause: The provided JSON schema contains nested objects or arrays. Resolution: Use a flat JSON structure with simple key-value pairs (no nesting or arrays).
- Rate limit exceeded Cause: Too many requests were sent in a short time period. Resolution: Add a short delay between requests or retry after some time to comply with rate limits.

