Actions5
- AI Chat Actions
- AI Generate Image Actions
- AI Text to Speech Actions
- Google Translate Actions
Overview
This node integrates with the Zukijourney AI platform to provide multiple AI-powered functionalities, including chat-based AI conversations, image generation and upscaling, text-to-speech audio creation, and text translation. Specifically, for the AI Chat resource with the AI Chat operation, it enables sending a sequence of messages to an AI chat model and receiving generated responses.
Common scenarios where this node is beneficial include:
- Building conversational agents or chatbots that leverage advanced AI models.
- Automating customer support or interactive assistants.
- Enriching workflows with AI-generated content based on user input.
- Incorporating vision capabilities by analyzing images alongside text in chat.
Practical example:
- A user sends a series of messages representing a conversation history, optionally including images for analysis, and receives a coherent AI-generated reply. The node supports streaming responses and function calling (tools) to extend interaction capabilities.
Properties
| Name | Meaning |
|---|---|
| Output Mode | Choose output format: • Full Response: Returns the complete API response with all details. • Simple: Returns only the main content, remaining credits, and total cost. |
| Model | The AI chat model to use for generating completions (e.g., "gpt-4.1-mini"). |
| Messages | Collection of messages to send to the model. Each message includes: • Role: System, User, Assistant, or Tool. • Content: Text content of the message. • Use Vision: Enable vision capabilities. • Image URL: URL of an image to analyze (if vision enabled). • Image Detail: Level of detail for image analysis (Low, High, Auto). |
| Temperature | Controls randomness of the response generation; value between 0 and 2. Higher values produce more creative outputs. |
| Max Tokens | Maximum number of tokens to generate in the response. |
| Top P | Nucleus sampling parameter controlling diversity; value between 0 and 1. |
| Stream | Whether to stream the response incrementally. |
| Options | Additional options: • Enable Tools: Enable function calling. • Tools: Define functions with name, description, and JSON schema parameters. • Tool Choice: How to select tools (Auto, None, Specific Function). • Specific Function: Name of the specific function to invoke if tool choice is "Specific Function". |
Output
The node outputs data in the json field with two possible formats depending on the selected Output Mode:
- Full Response: The entire API response object from the chat completion endpoint, including choices, usage, credits remaining, total cost, and any other metadata.
- Simple: A simplified object containing:
content: The generated text content from the first choice.credits_remaining: Remaining credits available in the account.total_cost: Total cost incurred by the request.
No binary data is produced for the AI Chat operation.
Dependencies
- Requires an API key credential for authenticating with the Zukijourney AI platform.
- Network access to the Zukijourney API endpoints.
- No additional environment variables are explicitly required beyond the API key credential configuration.
Troubleshooting
- Invalid API Key or Authentication Errors: Ensure the API key credential is correctly configured and valid.
- Malformed Messages Input: Verify that each message has a valid role and content. If using vision features, ensure the image URLs are accessible and properly formatted.
- Function Calling Misconfiguration: When enabling tools, confirm that the JSON schema for parameters is valid JSON and that the specified function names exist.
- Timeouts or Network Issues: The node sets timeouts for requests; network instability may cause errors. Retry or check connectivity.
- Error: "No binary data found in input": This error applies to other resources but not AI Chat. For AI Chat, ensure messages are correctly structured.
- Unsupported Output Mode: Only "full" and "simple" modes are supported; selecting others will cause unexpected behavior.
If the node throws errors related to unexpected properties or missing fields, review the input parameters carefully and consult the API documentation for correct usage.
Links and References
- Zukijourney AI Platform Documentation (hypothetical link as no direct link provided)
- OpenAI Chat Completion API concepts (similar usage): https://platform.openai.com/docs/guides/chat
- n8n Documentation on Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/