API reference · Ideogram

ideogram-ai/ideogram-v3/character/remix

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

IMAGEAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDideogram-ai/ideogram-v3/character/remix

Input Schema

9 parameters · 2 required · 7 optional

Parameter	Type	Required	Description
`image`	string	Required	The image URL to remix
`prompt`	string	Required	The prompt to remix the image with
`seed`	integer	Optional	Seed for the random number generator
`images`	string[]	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
`strength`	number	Optional	Strength of the input image in the remix · Min: 0.01 · Max: 1 · Default: 0.8
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`reference_masks`	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
`rendering_speed`	string	Optional	The rendering speed to use. · Options: TURBO, BALANCED, QUALITY · Default: "BALANCED" TURBOBALANCEDQUALITY
`reference_images`	string[]	Optional	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

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "ideogram-ai/ideogram-v3/character/remix",
  "image": "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v3/character/remix/input_image_0.avif",
  "prompt": "A glamorous portrait photograph of a woman in an elegant ballroom setting. The subject wears a champagne-colored ball gown with a fitted bodice, long sleeves, and a full skirt adorned with delicate lace appliques. The dress features a crystal-embellished hair accessory and pearl drop earrings. The grand staircase has ornate gold railings and leads to an elaborate crystal chandelier hanging from an arched ceiling. The walls are decorated with classical paintings featuring floral motifs. The lighting is warm and dramatic, creating a soft glow throughout the space. The composition is shot in a formal portrait style with the subject positioned on the lower landing of the staircase, looking over her shoulder at the camera.",
  "strength": 0.8,
  "rendering_speed": "BALANCED",
  "reference_images": [
    "https://static.sandbase.ai/examples/ideogram-ai/ideogram-v3/character/remix/input_reference_image_urls_1.png"
  ]
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Ideogram V3 Character Remix