Image models › Ideogram

Ideogram - Character

Image generation by ideogram/character ## Query Task Status After submitting a task, use the unified query endpoint to check progress and retrieve results: <Card title="Get Task Details" icon="lucide-search" href="/market/common/get-task-detail"> Learn how to query task status and retrieve generation results </Card> For production use, we recommend using the `callBackUrl` parameter to receive automatic notifications when generation completes, rather than polling the status endpoint. ## Related Resources <CardGroup cols={2}> <Card title="Market Overview" icon="lucide-store" href="/market/quicks

image Ideogram price on request

Request

POST https://app.video-blade.com/api/v1/generations
X-API-Key: vb_…
Content-Type: application/json

{
  "callback_url": "https://your-app.example/callbacks/video-blade",
  "input": {
    "prompt": "\u2026",
    "reference_image_urls": "\u2026"
  },
  "model": "ideogram-character"
}

Input parameters

Name	Type	Required	Description
`prompt`	string	required	The prompt to fill the masked part of the image. (Max length: 5000 characters)
`reference_image_urls`	array	required	A set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
`rendering_speed`	string	optional	The rendering speed to use. Default value: "BALANCED" Values: `TURBO`, `BALANCED`, `QUALITY` Default: `BALANCED`
`style`	string	optional	The style type to generate with. Cannot be used with style_codes. Default value: "AUTO" Values: `AUTO`, `REALISTIC`, `FICTION` Default: `AUTO`
`expand_prompt`	boolean	optional	Determine if MagicPrompt should be used in generating the request or not. Default value: true (Boolean value (true/false))
`num_images`	string	optional	Select description Values: `1`, `2`, `3`, `4` Default: `1`
`image_size`	string	optional	The resolution of the generated image Default value: square_hd Values: `square`, `square_hd`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` Default: `square_hd`
`seed`	integer	optional	Seed for the random number generator
`negative_prompt`	string	optional	Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. Default value: "" (Max length: 5000 characters)

Pricing

Price on request; the charge is settled from actual consumption with the image coefficient ×2.0. See Pricing & tokens.