Higgsfield Text 2 Image Soul

SOUL AI transforms text into stunning, customizable visuals with unparalleled style control and precision.


API

If you're looking for an API, you can choose from your desired programming language.

POST
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 import requests import base64 # Use this function to convert an image file from the filesystem to base64 def image_file_to_base64(image_path): with open(image_path, 'rb') as f: image_data = f.read() return base64.b64encode(image_data).decode('utf-8') # Use this function to fetch an image from a URL and convert it to base64 def image_url_to_base64(image_url): response = requests.get(image_url) image_data = response.content return base64.b64encode(image_data).decode('utf-8') # Use this function to convert a list of image URLs to base64 def image_urls_to_base64(image_urls): return [image_url_to_base64(url) for url in image_urls] api_key = "YOUR_API_KEY" url = "https://api.segmind.com/v1/higgsfield-text2image-soul" # Request payload data = { "prompt": "Heroic dragonborn warrior standing proudly on a rocky cliff, wearing ancient armor infused with glowing runes, holding a massive battle axe.", "width_and_height": "1536x2048", "enhance_prompt": False, "style_id": "b3c8075a-cb4c-42de-b8b3-7099dd2df672", "style_strength": 1, "quality": "1080p" } headers = {'x-api-key': api_key} response = requests.post(url, json=data, headers=headers) print(response.content) # The response is the generated image
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Guides the thematic direction of the image. For landscapes, use prompts like 'Misty forest at dusk'.


image_urlstr ( default: 1 )

Enhance or adjust an existing image with a URL. Use for precise edits or style transfers.


width_and_heightenum:str *

Defines the image size. Choose '1080p' for general use or '4K' for detailed visuals.

Allowed values:


enhance_promptboolean *

Boosts prompt detail accuracy. Use for scenes with complexities.


style_idstr *

Selects visual style. Opt for 'Realistic' for authenticity or 'Medieval' for imaginative renditions.


style_strengthfloat ( default: 1 )

Modulates style influence. Use 0.5 for subtle and 1 for bold stylization.

min : 0,

max : 1


qualityenum:str ( default: 1080p )

Controls resolution quality. Select '720p' for preview or '1080p' for clarity.

Allowed values:


seedint ( default: 1 )

Sets generation reproducibility. Use a fixed number for consistent results.

min : 1,

max : 1000000

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Resources to get you started

Everything you need to know to get the most out of Higgsfield Text 2 Image Soul

SOUL AI: Effective Usage Guide

SOUL AI is a powerful text-to-image generation model that turns your descriptions into finely styled visuals. This guide will help you unlock its full potential by explaining core parameters, best practices, and recommended settings for common creative workflows.

Getting Started

  1. Prompt
    – Craft a clear, concise description of your scene or subject (e.g., “A futuristic cityscape at night, neon reflections”).
    – Enable enhance_prompt for complex or multi-element scenes to boost detail accuracy.
  2. Resolution & Quality
    – Choose 1080p for polished outputs; use 720p for rapid previews.
    – Set width_and_height to match your layout:
    • 1536×2048 for portrait artwork
    • 2048×1536 for landscape scenes
    • 1536×1536 for square social media posts

Key Parameters Overview

  • style_id: Pick from 70+ predefined styles (e.g., Realistic, Medieval, Graffiti).
  • style_strength (0–1): Control how boldly the style applies (0.5 for subtle, 1 for full effect).
  • seed: Lock in a number for reproducible results across runs.
  • custom_reference_id + custom_reference_strength: Maintain character or object consistency in multi-image projects.

Recommended Settings by Use Case

  • E-commerce Product Visuals
    style_id: “Realistic”
    style_strength: 0.8
    quality: 1080p
    width_and_height: 1536×1536
  • Concept Art & Illustrations
    style_id: “Mixed Media” or “Foggy Morning”
    enhance_prompt: true
    style_strength: 1.0
    quality: 1080p, 2048×1536
  • Social Media Thumbnails
    style_id: “Y2K Posters” or “Glitch”
    style_strength: 0.7
    quality: 720p, 1152×1536

Prompt Crafting Tips

  • Lead with the main subject: “Majestic white wolf” before adjectives.
  • Layer in environment details: lighting, mood, time of day.
  • Use commas to separate visual elements.
  • Apply action words for dynamic scenes: “soaring,” “glimmering,” “cascading.”

Consistency & Advanced Controls

  • Seed: Specify an integer (e.g., 42) to regenerate the same composition.
  • Custom Reference: Upload a base image via image_url and set custom_reference_strength (0.6–1.0) to anchor style.
  • Batch Variations: Vary seed while holding prompt and style constant to explore subtle differences.
  • Webhook Integration: Automate your pipeline by linking a webhook URL for real-time callbacks on completed generations.

By fine-tuning these parameters and following the above guidelines, you’ll achieve consistent, high-quality images that precisely match your creative vision with SOUL AI.

Other Popular Models

Discover other models you might be interested in.

Cookie settings

We use cookies to enhance your browsing experience, analyze site traffic, and personalize content. By clicking "Accept all", you consent to our use of cookies.