POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/higgsfield-text2image-soul"; const 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" }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
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.

SOUL AI: Text-to-Image Generation Model

What is SOUL AI?

SOUL AI is the latest text-to-image generation model that utilizes the well-known Higgsfield API to create excellent-quality images from text prompts. It outperforms other similar models when it comes to rendering highly detailed images, thanks to its configurable options and settings for precision in visuals and style. It is a go-to model for creators who need detail-oriented results in their creations, owing to its remarkable image synthesis and a huge style catalogue.

Key Features of SOUL AI

  • It includes 70+ pre-defined styles and a wide range of options from "Realistic" to "Medieval"
  • It supports flexible resolution options - up to 2048x1536 output sizes
  • It provides higher accuracy by utilizing an advanced prompt enhancement system
  • It gives the option to customize reference handling with adjustable strength controls
  • It handles real-time webhook integration for seamless workflow automation
  • It integrates multiple quality presets (720p and 1080p) for different use cases
  • It is capable of precise style strength adjustment (0-1 range)

Best Use Cases

  • Creative agencies use it to create consistent branded visuals
  • Digital artists use it for reference to get inspired or use its base images
  • Content creators can design custom illustrations for their projects
  • E-commerce platforms can render product visualizations for their customers
  • Game developers can boost their games' vision and visuals by creating concept art
  • Fashion designers utilize it to experiment with their style variations
  • Social media content creation to produce a large volume of high-quality and engaging posts

Prompt Tips and Output Quality

  • To generate a precise and desired outcome, always provide clear prompts with detailed descriptions to include essential visual elements
  • The enhance_prompt feature is perfect for creating images with complex scenes or that need detailed elements
  • Achieve desired results by adjusting style_strength between 0.5 (subtle) and 1.0 (bold)
  • Get maximum details in the generated image by combining 1080p quality setting with larger resolution options
  • Using custom_reference_id will ensure consistency across multiple image creations
  • The precise tone and visualization for the project can be achieved by experimenting with different style presets

FAQs

How does SOUL AI handle style customization? SOUL AI offers pre-defined styles and custom reference options. Hence, the users can select from 70+ built-in styles and adjust their intensity, as per their requirement, using the style_strength parameter (0-1 range).

What's the maximum resolution supported? The model supports various aspect ratios with maximum dimensions of 2048x1536 pixels, perfect for high-quality commercial applications.

How can I ensure consistent results across multiple generations? Use the seed parameter to maintain consistency; for character-specific adjustments, combine custom_reference_id with custom_reference_strength.

What makes SOUL AI different from other text-to-image models? SOUL AI is preferred for professional creative workflows because of its vast style library, precise control parameters, and robust webhook support for real-time integration.

How can I optimize prompt enhancement for better results? Enable the enhance_prompt feature for complex scenes, and combine it with clear, descriptive prompts for optimal results; the 1080p setting will further improve the quality.