Ideogram Character API — how to connect and pay

API contract

Generation runs asynchronously: create a job, then poll its status until completion.

Create job

POST /api/media/generate

Check status

GET /api/media/jobs/{jobId}

Input

text, image

Output

image

Polling

every 3 s · up to 90 s

Authentication

Authorization: Bearer sk-pv-…

API request parameters

Parameters for requests to Ideogram Character via the GetVibe API.

Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.

Price of Ideogram Character

The cost of Ideogram Character: from $0.12 per image. The price is calculated dynamically at the current exchange rate, and the final charge is shown in the API response (priceRub). Payment in USD, no subscriptions.

README

The machine-readable contract for Ideogram Character contains the request schema, operations, limits, polling and response examples.

# Ideogram Character

Public model: ideogram-character
Create job: POST /api/media/generate
Check status: GET /api/media/jobs/{jobId}

## Input parameters
- `prompt` (text): text description; default: required
- `image_url` (URL): Public image URL; default: —
- `aspect_ratio` (option selection): 1:1 (default) · 16:9 · 9:16 · 4:3 · 3:4; default: 1:1
- `mode` (option selection): Create character (default) · Edit character (Canvas only) · Remix character; default: Create character
- `rendering_speed` (option selection): Turbo · Default (default) · Quality; default: Default
- `style` (option selection): Auto (default) · Realistic · Fiction; default: Auto
- `expand_prompt` (yes/no): Yes · No (default); default: No
- `seed` (text / number): any value; default: —
- `negative_prompt` (text / number): any value; default: —
- `strength` (option selection): 0.8 (default) (default) · 0.2 · 0.4 · 0.6 · 1.0; default: 0.8 (default)
- `num_images` (option selection): 1 (default) · 2 · 3 · 4; default: 1
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; default: —
- `input_urls` (Array<URLs>, 1–1 items): Public HTTP(S) URLs; default: required
- `input_file_ids` (Array<strings>): List of values; default: —
- `input_base64` (Array<strings>): List of values; default: —

## Public variants
- `ideogram-character`: Pixel
- `ideogram-character:rep`: Canvas