Image models › Ideogram

Ideogram - Character Edit

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

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",
    "mask_url": "\u2026",
    "prompt": "\u2026",
    "reference_image_urls": "\u2026"
  },
  "model": "ideogram-character-edit"
}

Input parameters

Name	Type	Required	Description
`prompt`	string	required	The prompt to fill the masked part of the image. (Max length: 5000 characters)
`image_url`	string	required	The image URL to generate an image from. Needs to match the dimensions of the mask. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)
`mask_url`	string	required	The mask URL to inpaint the image. Needs to match the dimensions of the input image. (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))
`num_images`	string	optional	Select description Values: `1`, `2`, `3`, `4` Default: `1`
`seed`	integer	optional	Seed for the random number generator

Pricing

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