IDEOGRAM V3

Base-Path:

https://api.hyprlab.io/v1

Image Path:

https://api.hyprlab.io/v1/images/generations

Making Request:

curl https://api.hyprlab.io/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HYPRLAB_API_KEY" \
  -d '{
    "model": "ideogram-v3-quality",
    "prompt": "cat",
    "negative_prompt": "..to not include specific elements.",
    "aspect_ratio": "1:1",
    "magic_prompt_option": "Auto",
    "style_type": "Anime",
    "response_format": "url",
    "output_format": "webp"
  }'

📌 Request Body Documentation

prompt (string, required)

• Description: Main text input to guide the generation process.

• Validation:

  • Must be a non-empty string.

  • Must not exceed 10,000 characters.

aspect_ratio (string, optional)

• Description: Defines the aspect ratio of the generated output.

• Validation:

  • Must be one of the following:

    • 1:3

    • 3:1

    • 1:2

    • 2:1

    • 9:16

    • 16:9

    • 10:16

    • 16:10

    • 2:3

    • 3:2

    • 3:4

    • 4:3

    • 4:5

    • 5:4

    • 1:1

style_type (string, optional)

• Description: Specifies the artistic style or genre for the output.

• Validation:

  • Must be one of the following valid style types:

    • Auto

    • General

    • Realistic

    • Design

style_preset (string, optional)

• Description: A predefined artistic style to the generated image.

• Validation:

  • Must be one of the following valid style presets:

    • None

    • 80s Illustration

    • 90s Nostalgia

    • Abstract Organic

    • Analog Nostalgia

    • Art Brut

    • Art Deco

    • Art Poster

    • Aura

    • Avant Garde

    • Bauhaus

    • Blueprint

    • Blurry Motion

    • Bright Art

    • C4D Cartoon

    • Children's Book

    • Collage

    • Coloring Book I

    • Coloring Book II

    • Cubism

    • Dark Aura

    • Doodle

    • Double Exposure

    • Dramatic Cinema

    • Editorial

    • Emotional Minimal

    • Ethereal Party

    • Expired Film

    • Flat Art

    • Flat Vector

    • Forest Reverie

    • Geo Minimalist

    • Glass Prism

    • Golden Hour

    • Graffiti I

    • Graffiti II

    • Halftone Print

    • High Contrast

    • Hippie Era

    • Iconic

    • Japandi Fusion

    • Jazzy

    • Long Exposure

    • Magazine Editorial

    • Minimal Illustration

    • Mixed Media

    • Monochrome

    • Nightlife

    • Oil Painting

    • Old Cartoons

    • Paint Gesture

    • Pop Art

    • Retro Etching

    • Riviera Pop

    • Spotlight 80s

    • Stylized Red

    • Surreal Collage

    • Travel Poster

    • Vintage Geo

    • Vintage Poster

    • Watercolor

    • Weird

    • Woodblock Print

magic_prompt_option (string, optional)

• Description: Toggle for an automatic magic prompt system.

• Validation:

  • Must be one of the following:

    • Auto, On, Off.

response_format (string, optional)

• Description: Defines how the response data is formatted.

• Validation:

  • Must be either "url" or "b64_json".

output_format (string, optional)

• Description: Specifies the format of the output image.

• Validation:

  • Must be one of the following formats:

    • png, jpeg, webp.

---

Pricing Details

Model Name:

• ideogram-v3-quality

Discount:

• 30% off

Price:

• $0.063 / Image

Model Name:

• ideogram-v3-balanced

Discount:

• 30% off

Price:

• $0.042 / Image

Model Name:

• ideogram-v3-turbo

Discount:

• 30% off

Price:

• $0.021 / Image