> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Ideogram 4.5 Text to Image > The Ideogram 4.5 Text to Image API generates 1–8 posters, logos and text-rich images per request, with low, medium or high quality and 42 sizes. > [!TIP] > > 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`. > 2. Regardless of whether `callback_url` is provided, you can retrieve the result through the unified [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) endpoint. Ideogram 4.5 Text to Image turns a prompt into posters, logos, packaging mockups, social graphics and other images where legible lettering matters. Request up to eight images at once and pick a quality tier that fits a draft or a final asset. Ideogram 4.5 is Ideogram's image model for text-heavy visuals and precise edits. Vidgo exposes it as two model IDs: [Text to Image](https://docs.vidgo.ai/api-manual/image-series/ideogram-v4-5-text-to-image.md) and [Edit](https://docs.vidgo.ai/api-manual/image-series/ideogram-v4-5-edit.md). ## Models * **ideogram/v4.5/text-to-image** — Text-to-image with Ideogram 4.5, 1–8 images per request. ## Features * Text-to-image focused on accurate in-image text (titles, slogans, labels). * 1–8 images per request with `n`. * Three quality tiers: `low`, `medium`, `high`. * Six aspect-ratio presets plus 36 exact pixel sizes, from 720x1280 up to 3328x1248 and 2048x2048. ## Required parameters * `prompt` (string): The image you want, 1–10,000 characters. Quote any text that must appear, for example `"GRAND OPENING"`. Must not be blank. ## Optional parameters * `n` (integer): Number of images, `1`–`8`. Default `1`. * `quality` (string): `low`, `medium` or `high`. Default `medium`. * `size` (string): Output size. Default `1:1 HD`. See [Size](#size). ## Size * Presets: `1:1`, `1:1 HD`, `4:3`, `3:4`, `16:9`, `9:16`. `1:1 HD` is a higher-resolution square. * Exact pixel sizes: `720x1280`, `720x1440`, `800x1280`, `832x1248`, `864x1152`, `896x1120`, `1024x1024`, `1024x3072`, `1120x896`, `1152x864`, `1152x2944`, `1248x832`, `1248x3328`, `1280x720`, `1280x800`, `1280x3072`, `1296x3168`, `1440x720`, `1440x2560`, `1440x2880`, `1600x2560`, `1664x2496`, `1728x2304`, `1792x2240`, `2048x2048`, `2240x1792`, `2304x1728`, `2496x1664`, `2560x1440`, `2560x1600`, `2880x1440`, `2944x1152`, `3072x1024`, `3072x1280`, `3168x1296`, `3328x1248`. * Any other value returns 400. ## Output The finished task returns one file per requested image (`n`) in the `files` array of [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) and the callback payload. ## Examples * **Poster with lettering**: a travel poster whose title is quoted in the prompt, `3:4`, `medium` quality. * **Four high-quality logo options with callback**: `n: 4`, `quality: high`, `1024x1024`, with a `callback_url`. ## Notes * This ID takes text only. To change an existing image, use [Ideogram 4.5 Edit](https://docs.vidgo.ai/api-manual/image-series/ideogram-v4-5-edit.md). * Fields not listed above return 400. `model` and `callback_url` belong at the request root, not inside `input`. * Credits are reserved at submission and depend on `quality` and `n` only; `size` does not change the price. A failed task is refunded in full. See the [pricing page](https://vidgo.ai/apis/api-pricing) for current rates. ## OpenAPI ````yaml api-manual/image-series/ideogram-v4-5-text-to-image.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Ideogram 4.5 Text to Image description: >- The Ideogram 4.5 Text to Image API generates 1–8 posters, logos and text-rich images per request, with low, medium or high quality and 42 sizes. version: 1.0.0 servers: - url: https://api.vidgo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Ideogram 4.5 Text to Image description: >- Send only the `input` fields listed for this model. Any other field, including image inputs, returns 400. operationId: submit_ideogram_v4_5_text_to_image requestBody: required: true content: application/json: schema: type: object required: - model - input properties: model: type: string description: Model ID. Use `ideogram/v4.5/text-to-image`. example: ideogram/v4.5/text-to-image callback_url: type: string format: uri nullable: true description: >- Optional public HTTP(S) endpoint that receives a POST when the task becomes `finished` or `failed`. HTTPS is recommended. Omit it, or send `null` or an empty string, to disable callbacks. example: https://your-domain.com/callback input: type: object required: - prompt properties: prompt: type: string minLength: 1 maxLength: 10000 description: >- Text prompt. Put any words that must appear in the image in quotes. 1–10,000 characters, not blank. example: >- A retro travel poster for "LISBON 1932", tram climbing a sunny hill, bold art deco lettering 'n': type: integer minimum: 1 maximum: 8 default: 1 description: Number of images to generate. quality: type: string enum: - low - medium - high default: medium description: Rendering quality. It sets the billing rate. size: type: string enum: - '1:1' - 1:1 HD - '4:3' - '3:4' - '16:9' - '9:16' - 1024x1024 - 1024x3072 - 1120x896 - 1152x2944 - 1152x864 - 1248x3328 - 1248x832 - 1280x3072 - 1280x720 - 1280x800 - 1296x3168 - 1440x2560 - 1440x2880 - 1440x720 - 1600x2560 - 1664x2496 - 1728x2304 - 1792x2240 - 2048x2048 - 2240x1792 - 2304x1728 - 2496x1664 - 2560x1440 - 2560x1600 - 2880x1440 - 2944x1152 - 3072x1024 - 3072x1280 - 3168x1296 - 3328x1248 - 720x1280 - 720x1440 - 800x1280 - 832x1248 - 864x1152 - 896x1120 default: 1:1 HD description: >- Output size: an aspect-ratio preset (`1:1 HD` is the higher-resolution square) or one of the exact pixel sizes in the list. additionalProperties: false description: Generation parameters. examples: poster: summary: Poster with lettering value: model: ideogram/v4.5/text-to-image input: prompt: >- A retro travel poster for "LISBON 1932", tram climbing a sunny hill, bold art deco lettering 'n': 1 quality: medium size: '3:4' logo_variants: summary: Four high-quality logo options with callback value: model: ideogram/v4.5/text-to-image callback_url: https://your-domain.com/callback input: prompt: >- Minimal flat logo for a coffee roastery called "Ember & Oak", warm orange on cream 'n': 4 quality: high size: 1024x1024 responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 description: HTTP status code. data: type: object required: - task_id - status - created_time properties: task_id: type: string description: >- Task ID. Use it with [Query Task Status](/api-manual/task-management/status). status: type: string enum: - not_started description: Initial task status. created_time: type: string format: date-time description: Time the task was created (ISO 8601). example: code: 200 data: task_id: task-unified-1762160000-abc123 status: not_started created_time: '2026-11-03T10:30:00' '400': description: >- Invalid input, unsupported field, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '502': description: Unable to create the upstream generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '503': description: The requested model is temporarily unavailable content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All API endpoints require Bearer Token authentication Get your API Key: Go to **Dashboard → API Key** ([API Key Management Page](https://vidgo.ai/apis/dashboard/api-key)) to get your API Key Add it to the request header: ``` Authorization: Bearer VIDGO_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.