> ## Documentation Index
> Fetch the complete documentation index at: https://platform.monica.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ideogram models

export const APIKeyHint = () => <Note>Follow the <a href="/docs/en/quickstart">quickstart guide</a> to get your own API Key.</Note>;

<APIKeyHint />

Ideogram is an advanced AI image generation model developed by [Ideogram AI](https://ideogram.ai/). See the [pricing page](/docs/en/models-and-pricing#image-generation) for pricing details.

**Ideogram V2**

* Latest version of Ideogram's image generation technology
* Exceptional text rendering capabilities
* Superior handling of typography and logos
* Precise control over text placement and style
* Ideal for:
  * Marketing materials
  * Brand assets
  * Social media content
  * Designs requiring text integration
  * Professional graphics with text elements

**Previews**

<Tabs>
  <Tab title="Ideogram V2">
    <img src="https://mintcdn.com/butterflyeffect-3a0f6b4e/XIP_99VNIjc_U1El/image-previews/ideogram-v2.webp?fit=max&auto=format&n=XIP_99VNIjc_U1El&q=85&s=78b33ea6d8fad39c3d7b1e29d619eeef" width="1312" height="736" data-path="image-previews/ideogram-v2.webp" />
  </Tab>
</Tabs>


## OpenAPI

````yaml POST /v1/image/gen/ideogram
openapi: 3.1.0
info:
  title: Monica Open API Platform
  version: v1
servers: []
security: []
tags:
  - name: image.v1.ImageGenerationService
    x-displayName: image.v1.ImageGenerationService
  - name: image.v1.ImageToolService
    x-displayName: image.v1.ImageToolService
  - name: text.v1.HumanizeService
    x-displayName: text.v1.HumanizeService
paths:
  /v1/image/gen/ideogram:
    post:
      tags:
        - image.v1.ImageGenerationService
      summary: IdeogramImageGeneration
      operationId: image.v1.ImageGenerationService.IdeogramImageGeneration
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/image.v1.IdeogramImageGenerationRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/image.v1.IdeogramImageGenerationResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    image.v1.IdeogramImageGenerationRequest:
      type: object
      properties:
        model:
          type: string
          examples:
            - V_2
          title: model
          enum:
            - V_2
          default: V_2
        prompt:
          type: string
          examples:
            - >-
              A serene tropical beach scene. Dominating the foreground are tall
              palm trees with lush green leaves, standing tall against a
              backdrop of a sandy beach. The beach leads to the azure waters of
              the sea, which gently kisses the shoreline. In the distance, there
              is an island or landmass with a silhouette of what appears to be a
              lighthouse or tower. The sky above is painted with fluffy white
              clouds, some of which are tinged with hues of pink and orange,
              suggesting either a sunrise or sunset.
          title: prompt
          maxLength: 1000
          minLength: 1
          description: The prompt to use to generate the image.
        aspect_ratio:
          type: string
          examples:
            - ASPECT_10_16
          title: aspect_ratio
          enum:
            - ASPECT_10_16
            - ASPECT_16_10
            - ASPECT_9_16
            - ASPECT_16_9
            - ASPECT_3_2
            - ASPECT_2_3
            - ASPECT_4_3
            - ASPECT_3_4
            - ASPECT_1_1
            - ASPECT_1_3
            - ASPECT_3_1
          description: >-
            The aspect ratio to use for image generation, which determines the
            image’s resolution.
          default: ASPECT_1_1
        magic_prompt_option:
          type: string
          examples:
            - AUTO
          title: magic_prompt_option
          enum:
            - AUTO
            - 'ON'
            - 'OFF'
          description: >-
            Determine if MagicPrompt should be used in generating the request or
            not.
          default: AUTO
        seed:
          type: integer
          examples:
            - 0
          title: seed
          maximum: 2147483647
          format: int32
          description: >-
            Random seed to use for the image generation process. If 0, we will
            use a totally random seed. Between 0 and 2147483647.
        negative_prompt:
          type: string
          examples:
            - ''
          title: negative_prompt
          maxLength: 4000
          description: >-
            Description of what to exclude from an image. Descriptions in the
            prompt take precedence to descriptions in the negative prompt.
        style_type:
          type: string
          examples:
            - AUTO
          title: style_type
          enum:
            - AUTO
            - GENERAL
            - REALISTIC
            - DESIGN
            - RENDER_3D
            - ANIME
          description: The style type to generate with.
          default: AUTO
      title: IdeogramImageGenerationRequest
      required:
        - prompt
      additionalProperties: false
    image.v1.IdeogramImageGenerationResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/image.v1.ImageResponseDataInner'
          title: data
          description: An array of generated image URLs.
      title: IdeogramImageGenerationResponse
      additionalProperties: false
    image.v1.ImageResponseDataInner:
      type: object
      properties:
        url:
          type: string
          title: url
          description: The URL of the generated image.
      title: ImageResponseDataInner
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````