Documentation Index
Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
Use this file to discover all available pages before exploring further.
Pricing: $0.06/image. Endpoint:
POST /v1/models/ideogram/v3/runs.Overview
- Endpoint: https://api.runflow.io/v1/models/ideogram/v3/runs
- Model ID: ideogram/v3
- Provider: Ideogram
- License: commercial
- Last Updated: 2026-04-06
Pricing
- Base price: $0.06/image
- Note: Balanced (default)
Ideogram v3 API
Endpoint:POST /v1/models/ideogram/v3/runs
Run the model
Python
Node.js
cURL
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
input | object | required | Model input parameters. See “Input schema” below. |
callback_url | string | null | optional | Webhook URL - POSTed when the run reaches a terminal state. |
metadata | object | null | optional | Arbitrary key-value pairs attached to the run. |
Input schema
| Field | Type | Required | Allowed values | Description |
|---|---|---|---|---|
prompt | string | required | Any | |
num_images | integer | optional | Any | Number of images to generate. |
image_size | string | optional | Any | The resolution of the generated image |
style | string | optional | Any | The style type to generate with. Cannot be used with style_codes. |
style_preset | string | optional | Any | Style preset for generation. The chosen style preset will guide the generation. |
expand_prompt | boolean | optional | Any | Determine if MagicPrompt should be used in generating the request or not. |
rendering_speed | string | optional | TURBO, BALANCED, QUALITY | The rendering speed to use. |
sync_mode | boolean | optional | Any | If True, the media will be returned as a data URI and the output data won’t be available in the request history. |
color_palette | json | optional | Any | A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members) |
style_codes | json | optional | Any | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
seed | integer | optional | Any | Seed for the random number generator |
image_urls | image_list | optional | Any | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
negative_prompt | string | optional | Any | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. |
Output schema
| Field | Type | Description |
|---|---|---|
outputs | json | Unified output array - one entry per generated artifact with url/type/width/height/duration/etc. |
seed | json | Seed used for the random number generator |
nsfw_detected | json | true if the provider flagged output as NSFW, false if cleared, null if not checked. |
timing | json | Provider timing info (inference_ms etc.), or null. |
Callback payload
When you provide acallback_url, Runflow POSTs to it once the run reaches a terminal state.
| Field | Type | Description |
|---|---|---|
event | string | Event type: “run.completed”, “run.failed”, or “run.cancelled”. |
run_id | string | The unique identifier of the run. |
status | string | Terminal status: “succeeded”, “failed”, or “cancelled”. |
output | object | null | The run output. Null if the run failed or was cancelled. |
duration_ms | number | null | Total run duration in milliseconds. |
created_at | string | null | ISO 8601 timestamp when the run was created. |
completed_at | string | null | ISO 8601 timestamp when the run reached terminal state. |
metadata | object | null | The metadata object passed at run creation, if any. |
- Retries: 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
- Headers:
Runflow-Request-Idis always sent.Runflow-Signatureis sent if a signing secret is configured.
Additional Resources
Related
Browse all models
Browse the catalog.
Run lifecycle
Callbacks, polling, statuses.
Callbacks
Handle async results.
Pricing
How requests bill out.