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.
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
Attributes
Guides the thematic direction of the image. For landscapes, use prompts like 'Misty forest at dusk'.
Enhance or adjust an existing image with a URL. Use for precise edits or style transfers.
Defines the image size. Choose '1080p' for general use or '4K' for detailed visuals.
Allowed values:
Boosts prompt detail accuracy. Use for scenes with complexities.
Selects visual style. Opt for 'Realistic' for authenticity or 'Medieval' for imaginative renditions.
Modulates style influence. Use 0.5 for subtle and 1 for bold stylization.
min : 0,
max : 1
Controls resolution quality. Select '720p' for preview or '1080p' for clarity.
Allowed values:
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
- •Prompt
– Craft a clear, concise description of your scene or subject (e.g., “A futuristic cityscape at night, neon reflections”).
– Enableenhance_prompt
for complex or multi-element scenes to boost detail accuracy. - •Resolution & Quality
– Choose1080p
for polished outputs; use720p
for rapid previews.
– Setwidth_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 setcustom_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.
sdxl-controlnet
SDXL ControlNet gives unprecedented control over text-to-image generation. SDXL ControlNet models Introduces the concept of conditioning inputs, which provide additional information to guide the image generation process

idm-vton
Best-in-class clothing virtual try on in the wild

faceswap-v2
Take a picture/gif and replace the face in it with a face of your choice. You only need one image of the desired face. No dataset, no training

sd2.1-faceswapper
Take a picture/gif and replace the face in it with a face of your choice. You only need one image of the desired face. No dataset, no training
