BytePlusInstall

Summary

Generates images from text prompts using BytePlus Seedream models, with optional input image for image-to-image generation. Returns the generated image as binary data (when response format is URL, the default) and provides image URL in JSON output. If response format is Base64, base64 data is in rawResponse and no binary data is returned. Configurable model (Seedream 4.5/4.0/custom), size (default 2K), and watermark.

Inputs

• prompt (required) — Text description of the image to generate
• image — Optional input image URL or base64 string for image-to-image generation
• model — Model to use (Seedream 4.5 by default, Seedream 4.0, or custom)
• customModel — Custom model ID (when model is set to custom)
• size — Size of the generated image (default 2K)
• additionalOptions.responseFormat — Format of the returned image (URL or Base64, default URL)
• additionalOptions.watermark — Whether to add a watermark to the generated image (default false)

Output shape

Returns an object with JSON and binary properties. JSON contains: success (true), prompt, imageUrl (if API returned URL), rawResponse (full API response). Binary contains image data (if API returned URL and download succeeded) as a binary object suitable for display in n8n nodes.

Requires bytePlusApi credential. When response format is Base64, the node does not convert base64 to binary data; the base64 string is available in rawResponse and must be handled manually.

Examples

Example 1: Text-to-image generation with default settings

Prompt: 'A futuristic cityscape', Model: Seedream 4.5 (default), Size: 2K (default), Response Format: URL (default), Watermark: false

Example 2: Image-to-image generation with custom model

Prompt: 'Add a cat to the image', Image: 'https://example.com/input.jpg', Model: Custom, Custom Model: 'seedream-4-5-custom', Size: 1024x1024, Response Format: URL, Watermark: true

Links

• n8n community nodes installation guide