Image models › Ideogram

Ideogram - Character Remix

Image generation by ideogram/character-remix ## 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/

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": {
    "image_url": "\u2026",
    "prompt": "\u2026",
    "reference_image_urls": "\u2026"
  },
  "model": "ideogram-character-remix"
}

Input parameters

Name	Type	Required	Description
`prompt`	string	required	The prompt to remix the image with (Max length: 5000 characters)
`image_url`	string	required	The image URL to remix (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
`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))
`image_size`	string	optional	Select description Values: `square`, `square_hd`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` Default: `square_hd`
`num_images`	string	optional	Select description Values: `1`, `2`, `3`, `4` Default: `1`
`seed`	integer	optional	Seed for the random number generator
`strength`	number	optional	Strength of the input image in the remix Default value: 0.8 (Min: 0.1, Max: 1, Step: 0.1) (step: 0.1) Default: `0.8`
`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: 500 characters)
`image_urls`	array	optional	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 (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
`reference_mask_urls`	string	optional	A set of masks to apply to the character references. Currently only 1 mask is supported, rest will be ignored. (maximum total size 10MB across all character references). The masks 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)

Pricing

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