ideogram-v3:pixeldefaultcheapestIdeogram v3 API — how to connect and pay
Ideogram v3 — excellent text rendering on images. Modes: generation, remix and cropping (the latter two — Pixel only); mask-free editing — Canvas only.
Channel comparison
last 7 days
ideogram-v3:rep| Channel | Price |
|---|---|
Pixel ideogram-v3:pixeldefaultcheapest | from $0.023333 per image |
Canvas ideogram-v3:rep | from $0.04 per image |
Build the result you need
ideogram-v3:pixelWhat is Ideogram v3
Ideogram v3 — excellent text rendering on images. Modes: generation, remix and cropping (the latter two — Pixel only); mask-free editing — Canvas only.
Contract at a glance
- Input
- text, image
- Output
- image
- Mode
- async (job + polling)
- Status polling
- every 3 s · up to 90 s
Strengths
- Pricing: per image
- Inputs: text, image
- 5 configurable options
- One API key for media generation
Where it is used
- Article and social media illustrations
- Product images
- Banners and covers
- Design prototypes
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-…
Example request
Pass your key in the Bearer header. The API returns jobId for polling the status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"ideogram-v3:pixel","prompt":"a beautiful landscape","opts":{"mode":"text-to-image","aspect_ratio":"1:1","rendering_speed":"DEFAULT","style":"AUTO","expand_prompt":false,"num_images":"1"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "ideogram-v3:pixel",
"prompt": "a beautiful landscape",
"opts": {
"mode": "text-to-image",
"aspect_ratio": "1:1",
"rendering_speed": "DEFAULT",
"style": "AUTO",
"expand_prompt": false,
"num_images": "1"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API request parameters
Parameters for requests to Ideogram v3 via the GetVibe API.
promptreq.image_urlaspect_ratiomoderendering_speedstyleexpand_promptseednegative_promptstrengthnum_imagesimage_file_idimage_base64| Parameter | Type | Values | Default | Price |
|---|---|---|---|---|
promptreq. | text | text description | required | — |
image_url | URL | Public image URL | — | — |
aspect_ratio | option selection | 1:1 (default) · 16:9 · 9:16 · 4:3 · 3:4 | 1:1 | Included in the base price |
mode | option selection | Generate (text → image) (default) · Edit (Canvas only) · Remix · Reframe | Generate (text → image) | Included in the base price |
rendering_speed | option selection | Turbo · Default (default) · Quality | Default | Turbo: $0.023333, Default: $0.046667, Quality: $0.066667 |
style | option selection | Auto (default) · General · Realistic · Design | Auto | Included in the base price |
expand_prompt | yes/no | Yes · No (default) | No | Included in the base price |
seed | text / number | any value | — | Included in the base price |
negative_prompt | text / number | any value | — | Included in the base price |
strength | option selection | 0.8 (default) (default) · 0.2 · 0.4 · 0.6 · 1.0 | 0.8 (default) | Included in the base price |
num_images | option selection | 1 (default) · 2 · 3 · 4 | 1 | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.
Price of Ideogram v3
The cost of Ideogram v3: from $0.023333 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.
What a default request costs
With no parameters sent, the request uses these values: Generation speed — Default, Mode — Generate (text → image), Frame format — 1:1, Style — Auto. That request costs $0.046667.
“from $0.023333” is the cheapest parameter set, not the price of a default request.
Channels and prices for every parameter combination
For every channel, the price of every parameter combination. It is exactly the amount a successful generation is charged, and the same figure as in the machine-readable table linked below.
Pixelideogram-v3:pixelfrom $0.023333exact prices
| Speed | Turbo | Default | Quality |
|---|---|---|---|
| Pixel | $0.023333 | $0.046667 | $0.066667 |
Every combination as JSON: /api/media/price-table?model=ideogram-v3%3Apixel
Canvasideogram-v3:repfrom $0.04exact prices
| Speed | Turbo | Default | Quality |
|---|---|---|---|
| Canvas | $0.04 | $0.08 | $0.12 |
Every combination as JSON: /api/media/price-table?model=ideogram-v3%3Arep
README
The machine-readable contract for Ideogram v3 contains the request schema, operations, limits, polling and response examples.
# Ideogram v3
Public model: ideogram-v3:pixel
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): Generate (text → image) (default) · Edit (Canvas only) · Remix · Reframe; default: Generate (text → image)
- `rendering_speed` (option selection): Turbo · Default (default) · Quality; default: Default
- `style` (option selection): Auto (default) · General · Realistic · Design; 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: —
## Public variants
- `ideogram-v3:pixel`: Pixel
- `ideogram-v3:rep`: CanvasFAQ about the Ideogram v3 API
How much does Ideogram v3 cost?
The price of Ideogram v3: from $0.023333 per image. The price is calculated dynamically at the current exchange rate.
Is it compatible with the OpenAI SDK?
Yes, the API is fully OpenAI-compatible. Just change base_url to https://getvibeapi.com/v1 and set your key — the rest of the code stays the same.