n8n ByteDance Seedream 3 Text-to-Image Transformation Template

This n8n workflow provides a basic template for interacting with a text-to-image API, likely ByteDance Seedream 3, though the specific API details are not fully configured in the provided JSON. It demonstrates how to trigger an API request, potentially process its response, and handle different outcomes.

What it does

This workflow outlines the following steps:

1. Manual Trigger: The workflow is initiated manually by clicking the 'Execute workflow' button in n8n.
2. Edit Fields (Set): This node is intended for setting or modifying data. In a real scenario, this would likely be used to prepare the prompt or other parameters for the text-to-image API.
3. HTTP Request: This node is configured to make an API call. Based on the workflow's name, this is where the request to the ByteDance Seedream 3 text-to-image API would be made.
4. If: This node introduces conditional logic. It would typically be used to check the status or response of the API call (e.g., success, error, image generated).
5. Code (on True branch): If the 'If' condition evaluates to true, this node executes custom JavaScript code. This could be used for further processing of a successful API response, such as extracting image URLs or metadata.
6. Wait (on False branch): If the 'If' condition evaluates to false, this node introduces a pause in the workflow. This might be used to implement a retry mechanism for failed API calls or to wait for a resource to become available.
7. Sticky Note: A sticky note is included for documentation or comments within the workflow.

Prerequisites/Requirements

• n8n Instance: An active n8n instance to import and run the workflow.
• ByteDance Seedream 3 API Access: While not explicitly configured in the JSON, a ByteDance Seedream 3 API endpoint and any necessary authentication (e.g., API keys, tokens) would be required to make the HTTP Request node functional for its intended purpose.

Setup/Usage

1. Import the Workflow:
   • Copy the provided JSON code.
   • In your n8n instance, click on "Workflows" in the left sidebar.
   • Click "New" -> "Import from JSON" and paste the copied JSON.
   • Click "Import".
2. Configure the Edit Fields Node:
   • Open the "Edit Fields" node.
   • Add or modify fields to define the text prompt or any other parameters required by the ByteDance Seedream 3 API.
3. Configure the HTTP Request Node:
   • Open the "HTTP Request" node.
   • Set the Method (e.g., POST).
   • Enter the URL for the ByteDance Seedream 3 text-to-image API endpoint.
   • Configure Authentication (e.g., API Key, Bearer Token) as required by the API.
   • Set the Body Parameters to send the prompt and other necessary data, referencing the output from the "Edit Fields" node.
4. Configure the If Node:
   • Open the "If" node.
   • Define the conditions to check the response from the HTTP Request node (e.g., statusCode is 200, response.data.image_url exists).
5. Configure the Code Node (True branch):
   • If you want to process the successful API response, open the "Code" node connected to the "True" output of the "If" node.
   • Add JavaScript code to extract and transform the image data or URL.
6. Configure the Wait Node (False branch):
   • If you want to handle failed API calls, open the "Wait" node connected to the "False" output of the "If" node.
   • Adjust the wait time or consider adding additional nodes for error logging or retry logic.
7. Activate and Execute:
   • Save the workflow.
   • Click "Activate" to enable the workflow.
   • Click "Execute Workflow" on the "Manual Trigger" node to run the workflow.