Run Straico Image Generation

Action ID: straico_image_generate

Description

Run a image generation using the Straico API.

Connection

Name	Description	Required	Category
Straico Connection	The Straico connection to use for the model.	True	straico

Input Parameters

Name	Type	Required	Default	Description
model	dropdown	-	openai/dall-e-3	The AI model to use for image generation. Available options: openai/dall-e-3, flux/1.1, ideogram/V_2A, ideogram/V_2A_TURBO, ideogram/V_2, ideogram/V_2_TURBO, ideogram/V_1, ideogram/V_1_TURBO
description	string	✓	-	A detailed textual description of the image to be generated
size	dropdown	-	square	The desired image dimensions. Available options: square, landscape, portrait
variations	integer	-	1	Number of images to generate. Range: 1 to 4

View JSON Schema

{
  "description": "Run Straico image generation node input.",
  "properties": {
    "model": {
      "default": "openai/dall-e-3",
      "description": "The AI model to use for image generation",
      "enum": [
        "openai/dall-e-3",
        "flux/1.1",
        "ideogram/V_2A",
        "ideogram/V_2A_TURBO",
        "ideogram/V_2",
        "ideogram/V_2_TURBO",
        "ideogram/V_1",
        "ideogram/V_1_TURBO"
      ],
      "title": "Model",
      "type": "string"
    },
    "description": {
      "description": "A detailed textual description of the image to be generated",
      "title": "Description",
      "type": "string"
    },
    "size": {
      "default": "square",
      "description": "The desired image dimensions",
      "enum": [
        "square",
        "landscape",
        "portrait"
      ],
      "title": "Size",
      "type": "string"
    },
    "variations": {
      "default": 1,
      "description": "Number of images to generate",
      "maximum": 4,
      "minimum": 1,
      "title": "Variations",
      "type": "integer"
    }
  },
  "required": [
    "description"
  ],
  "title": "StraicoImageGenerateInput",
  "type": "object"
}

Output Parameters

Name	Type	Description
success	boolean	Whether the image generation was successful
data	object	The data from the image generation (contains zip, images, and price)
error	string	If the image generation was not successful, this will contain an error message

Data Object Structure:

• zip: URL to download a ZIP file containing all generated images

• images: Array of URLs, each pointing to an individual generated image

• price: Detailed pricing information (price_per_image, quantity_images, and total)

View JSON Schema

{
  "$defs": {
    "StraicoImageGenerateData": {
      "description": "Output from a Straico image generation.",
      "properties": {
        "zip": {
          "description": "URL to download a ZIP file containing all generated images",
          "title": "ZIP Download",
          "type": "string"
        },
        "images": {
          "description": "Array of URLs, each pointing to an individual generated image",
          "items": {
            "type": "string"
          },
          "title": "Image URLs",
          "type": "array"
        },
        "price": {
          "additionalProperties": true,
          "description": "Detailed pricing information for the request. Includes price_per_image, quantity_images, and total",
          "title": "Price",
          "type": "object"
        }
      },
      "required": [
        "zip",
        "images",
        "price"
      ],
      "title": "StraicoImageGenerateData",
      "type": "object"
    }
  },
  "description": "Output from a Straico image generation.",
  "properties": {
    "data": {
      "anyOf": [
        {
          "$ref": "#/$defs/StraicoImageGenerateData"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The data from the image generation.",
      "title": "Data"
    },
    "success": {
      "description": "Whether the image generation was successful.",
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If the image generation was not successful, this will contain an error message.",
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "StraicoImageGenerateOutput",
  "type": "object"
}

How It Works

This node generates AI images through the Straico API, which provides unified access to multiple image generation models including OpenAI's DALL-E, Flux, and Ideogram. When you provide a text description, the node sends your request to Straico with the selected model and parameters. Straico processes the request, generates the specified number of image variations, and returns URLs to access each generated image individually or as a bundled ZIP download. The response includes detailed pricing information showing the cost per image and total cost, allowing you to track usage and expenses effectively.

Usage Examples

Example 1: Single Product Mockup

Input:

model: "openai/dall-e-3"
description: "Professional product photography of a minimalist smart watch with black metal band on marble surface, studio lighting, commercial photography, high detail"
size: "square"
variations: 1

Output:

success: true
data: {
  "zip": "https://straico.com/downloads/batch-abc123.zip",
  "images": ["https://straico.com/images/smartwatch-001.png"],
  "price": {
    "price_per_image": 0.04,
    "quantity_images": 1,
    "total": 0.04
  }
}
error: null

Example 2: Multiple Variations for Selection

Input:

model: "flux/1.1"
description: "Modern logo design for a tech startup, geometric shapes, blue and green gradient, minimalist, professional, vector style, clean design"
size: "square"
variations: 4

Output:

success: true
data: {
  "zip": "https://straico.com/downloads/batch-def456.zip",
  "images": [
    "https://straico.com/images/logo-var1.png",
    "https://straico.com/images/logo-var2.png",
    "https://straico.com/images/logo-var3.png",
    "https://straico.com/images/logo-var4.png"
  ],
  "price": {
    "price_per_image": 0.02,
    "quantity_images": 4,
    "total": 0.08
  }
}
error: null

Example 3: Social Media Header Image

Input:

model: "ideogram/V_2A_TURBO"
description: "Abstract digital art background with flowing waves, vibrant purple and cyan colors, smooth gradients, modern aesthetic, banner design, high resolution"
size: "landscape"
variations: 2

Output:

success: true
data: {
  "zip": "https://straico.com/downloads/batch-ghi789.zip",
  "images": [
    "https://straico.com/images/header-opt1.png",
    "https://straico.com/images/header-opt2.png"
  ],
  "price": {
    "price_per_image": 0.01,
    "quantity_images": 2,
    "total": 0.02
  }
}
error: null

Common Use Cases

• Marketing Materials: Generate custom images for social media posts, blog headers, and advertising campaigns

• Product Mockups: Create product visualizations and concept designs without expensive photography

• Logo Design: Generate multiple logo variations for clients to review and select from

• Content Creation: Produce unique illustrations for articles, presentations, and educational materials

• A/B Testing: Create multiple image variations to test which performs better in marketing campaigns

• Rapid Prototyping: Quickly generate visual concepts for design reviews and stakeholder presentations

• Batch Processing: Generate multiple variations at once to provide options and alternatives

Error Handling

Error Type	Cause	Solution
Authentication Failed	Invalid or missing Straico API credentials	Verify your Straico connection configuration and API key
Empty Description	Description parameter is empty or missing	Provide a detailed text description of the image you want to generate
Invalid Model	Selected model is not available or misspelled	Choose a valid model from the supported list (openai/dall-e-3, flux/1.1, ideogram variants)
Variations Out of Range	Variations value is not between 1 and 4	Set variations to a value between 1 and 4 inclusive
Content Policy Violation	Description contains prohibited or unsafe content	Revise description to comply with Straico's content policies
Insufficient Credits	Straico account doesn't have enough credits	Add credits to your Straico account or reduce number of variations
Generation Timeout	Request taking longer than expected to process	Wait and retry, or simplify the description for faster generation

Notes

• Model Selection: DALL-E 3 excels at following detailed prompts, Flux is fast and cost-effective, Ideogram variants offer different speed/quality tradeoffs

• Cost Tracking: The price object in the response helps you monitor costs. TURBO models are cheaper but may have lower quality

• Multiple Variations: Generate 2-4 variations to have options to choose from, especially useful for creative work like logo design

• ZIP Downloads: Use the zip URL to download all generated images in one batch, convenient when generating multiple variations

• Description Quality: More detailed descriptions produce better results. Include style, lighting, colors, mood, and composition details

• Size Options: Square (1:1) works for social media, landscape for banners and headers, portrait for mobile-oriented content

• Success Checking: Always check the success field before accessing data. If false, check the error field for details

• Turbo Models: Ideogram TURBO variants are faster and cheaper but may produce slightly lower quality results than standard versions