image-generation

Create Stunning Images from Text with Instant Style

26 Apr 2025
Create Stunning Images from Text with Instant Style

In the realm of digital creativity, the ability to generate images from text prompts has revolutionized how content is created and shared. The "Instant Style" service offers developers a powerful set of Cognitive Actions that enable the generation of images while preserving the artistic style of a reference image. This innovative approach not only enhances visual storytelling but also provides a high degree of customizability, allowing for tailored outputs that fit specific needs.

With Instant Style, developers can quickly transform ideas into vivid visual representations, making it ideal for use cases such as creating unique artwork, enhancing marketing materials, and developing engaging social media content. Whether you're a game developer looking to design characters or a digital artist seeking inspiration, Instant Style simplifies the image generation process while maintaining the integrity of your chosen style.

Prerequisites

To get started with Instant Style, you'll need an API key for the Cognitive Actions service and a basic understanding of how to make API calls.

Generate Style-Preserving Text-to-Image

The primary action available through Instant Style is the Generate Style-Preserving Text-to-Image, which allows users to create images based on textual input while keeping the stylistic elements of a reference image intact. This action addresses the challenge of blending creativity with specific visual requirements, enabling developers to achieve a seamless integration of text and imagery.

Input Requirements

To utilize this action, you'll need to provide several parameters, including:

  • prompt: The text prompt that guides the image generation (e.g., "A dog").
  • styleImageUri: The URI of the reference style image.
  • width and height: Dimensions of the output image (between 512 and 2048 pixels).
  • blockMode: Defines how the reference image influences the output (options include "original," "style-only," and "style-and-layout").
  • adapterMode: Determines the flexibility versus fidelity of the output (options are "original" or "plus").
  • styleInfluence: Controls the degree of style transfer from the reference image (ranging from 0 to 2).
  • numberOfOutputs: Specifies how many images to generate (between 1 and 4).
  • Additional parameters like negativePromptText, guidanceScaleFactor, and others help refine the output further.

Expected Output

The output of this action will be a URL linking to the generated image, which reflects the input prompt and adheres to the style of the reference image. For example, if the input prompt is "A dog," the output could be a beautifully rendered image of a dog in the style you provided.

Example output:

"https://assets.cognitiveactions.com/invocations/91bd6a50-09f7-4631-9fdd-9760249fd3be/cafb87f5-19fc-45b3-8fcd-00d27d2d9372.png"

Use Cases for this Specific Action

  • Digital Art Creation: Artists can leverage this action to create unique pieces that reflect their vision while drawing inspiration from existing styles.
  • Marketing Materials: Businesses can generate eye-catching visuals for campaigns that align with their brand's aesthetic.
  • Social Media Content: Content creators can produce engaging and visually appealing posts that stand out in crowded feeds.
  • Game Development: Developers can create character designs or environmental art that fit a specific artistic direction, enhancing the overall game experience.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "40ce7e12-b5d6-4253-9a3e-51f29871b6ba" # Action ID for: Generate Style-Preserving Text-to-Image

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "width": 1024,
  "height": 1024,
  "prompt": "A dog",
  "blockMode": "style-only",
  "adapterMode": "original",
  "styleImageUri": "https://replicate.delivery/pbxt/KgoIir7Dz5vLdvy1ZOspa1dVI8L6FldaTuGH4d2QYDx1NGjl/0.jpg",
  "styleInfluence": 1,
  "numberOfOutputs": 1,
  "guidanceScaleFactor": 5,
  "enableNegativeContent": false,
  "numberOfInferenceSteps": 30,
  "negativeContentInfluence": 0.5
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

The Instant Style service offers a transformative solution for developers looking to enhance their visual content through style-preserving image generation. By allowing for high customization and flexibility, this service empowers users to bring their creative ideas to life while maintaining artistic integrity. As you explore the possibilities with Instant Style, consider how these actions can streamline your workflow and elevate your projects to new heights. Start integrating today and unlock a world of creativity at your fingertips!

← Back to All Articles