Generate Stunning Images with Ideogram v2 Turbo Cognitive Actions

21 Apr 2025
Generate Stunning Images with Ideogram v2 Turbo Cognitive Actions

In today's digital landscape, the demand for high-quality images is ever-growing. The ideogram-ai/ideogram-v2-turbo API offers developers a robust set of Cognitive Actions designed to simplify and accelerate the image generation process. With a focus on creativity and speed, these pre-built actions enable developers to generate visually appealing images that can be used for marketing, product design, or simply for ideation purposes. In this article, we will delve into one of the key actions available in this API: Generate Image with Ideogram v2 Turbo.

Prerequisites

Before getting started with the Cognitive Actions, you will need:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON structures to format the input and understand the output.

Authentication typically involves passing your API key in the request headers.

Cognitive Actions Overview

Generate Image with Ideogram v2 Turbo

The Generate Image with Ideogram v2 Turbo action allows for rapid image creation with the Ideogram v2 Turbo model, excelling in inpainting, prompt comprehension, and text rendering. This action is ideal for generating creative designs, logos, posters, and more, all tailored to various aesthetic styles and resolutions.

Input

The action accepts the following input parameters, which you can structure in JSON format:

  • prompt: (required) A detailed text prompt that guides the image generation process.
  • baseImage: (optional) A URI for an image file used as a base for inpainting operations.
  • randomSeed: (optional) An integer used to initialize the random number generator for consistent results.
  • excludePrompt: (optional) Text describing elements to exclude from the generated image.
  • imageStyleType: (optional) Defines the aesthetic style of the image. Options include "None", "Auto", "General", "Realistic", "Design", "Render 3D", "Anime".
  • inpaintingMask: (optional) A URI for a black and white mask image indicating areas to be altered in the base image.
  • outputResolution: (optional) Specifies the output image resolution, which overrides aspect ratio settings.
  • desiredAspectRatio: (optional) Specifies the desired aspect ratio of the image.
  • promptEnhancerOption: (optional) Guides the prompt enhancement process to improve the variety and quality of generated images.

Example Input JSON:

{
  "prompt": "An illustration of a gold running shoe with the text \"Run AI with an API\" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.",
  "imageStyleType": "None",
  "outputResolution": "None",
  "desiredAspectRatio": "1:1",
  "promptEnhancerOption": "Auto"
}

Output

The output of this action is a URL linking to the generated image. This image URL can be directly accessed to view or download the image.

Example Output:

https://assets.cognitiveactions.com/invocations/3df139f8-3245-4719-9de4-4288c2d8cd89/e21dba7a-d272-48dd-a8bb-2a5fb3f3675e.png

Conceptual Usage Example (Python)

Here's how you could invoke the Generate Image with Ideogram v2 Turbo action using Python:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "12be24a5-0145-48a3-8132-855a1f7a43c6"  # Action ID for Generate Image with Ideogram v2 Turbo

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "An illustration of a gold running shoe with the text \"Run AI with an API\" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.",
    "imageStyleType": "None",
    "outputResolution": "None",
    "desiredAspectRatio": "1:1",
    "promptEnhancerOption": "Auto"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this Python code snippet, you will need to replace the COGNITIVE_ACTIONS_API_KEY with your actual API key and adjust the endpoint URL as necessary. The action ID and input payload are structured according to the requirements of the Generate Image with Ideogram v2 Turbo action.

Conclusion

The ideogram-ai/ideogram-v2-turbo Cognitive Action for image generation offers a powerful tool for developers looking to create stunning visuals with ease and speed. By leveraging the capabilities of this API, you can enhance your applications with unique and tailored images that meet your creative needs. Start exploring the possibilities today and consider integrating this action into your projects for a more dynamic user experience!

← Back to All Articles