AI Influencer
Text to image
Starting price $0.08 / image
By Ideogram
Ideogram Character keeps one person's look from a single reference photo and places them in new scenes, edits or remixes.
ideogram/characterThis model has other modes with their own ids: ideogram/character/edit, ideogram/character/remix.
Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.
# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
-H "Authorization: Bearer $RAYWAKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram/character",
"input": {
"prompt": "The character sits at a window table in a busy café, laughing over a cup of coffee, soft morning light, candid photo style.",
"reference_image_urls": [
"https://example.com/input.png"
]
}
}'
# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
-H "Authorization: Bearer $RAYWAKE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"model": "ideogram/character", "quote_id": "QUOTE_ID", "input": {"prompt":"The character sits at a window table in a busy café, laughing over a cup of coffee, soft morning light, candid photo style.","reference_image_urls":["https://example.com/input.png"]}}'
# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
-H "Authorization: Bearer $RAYWAKE_API_KEY"| Name | Type | Description |
|---|---|---|
image_urls | array of image URLs | 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 |
rendering_speed | string (enum) | The rendering speed to use. |
style_codes | array of strings | A list of 8-character hexadecimal codes for the style of the image. Cannot be used with style reference images or Style. |
style | string (enum) | The style type to generate with. Cannot be used with style codes. |
enable_prompt_expansion | boolean | Determine if MagicPrompt should be used in generating the request or not. |
num_images | integer | Number of images to generate. |
seed | integer | Seed for the random number generator |
sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
promptrequired | string | Describe the image to create with the character. |
image_size | string (enum) | The resolution of the generated image |
negative_prompt | string | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. |
reference_image_urlsrequired | array of image URLs | 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 |
reference_mask_urls | array of image URLs | 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 |
A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.
"outputs": [
{ "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]The exact charge for your input comes from a quote. How charges settle
Fields marked * are required. Review the price before generating.
Give one reference image of a character and describe a scene; the face and distinctive features carry over into each new image. Up to 8 images per run, in square, portrait or landscape sizes, with Turbo, Balanced or Quality rendering.
The edit mode paints the character into a masked area of an image you already have. The remix mode reworks an existing image around the character, with a strength setting for how much of the original stays.
Compare facial features, clothing and proportions with the reference. Character resemblance is a result to inspect, not a guarantee.