Ideogram character reference API: what Sume passes through

Ideogram's own API lets a request carry a character reference. Sume lists ideogram/ideogram-v3 in its image catalog, but Sume's docs do not describe a character reference parameter for it: what you can send is input_references, aspect_ratio, a low, medium or high quality, and n.

Ideogram's feature is from its Generate 3.0 API page; Sume's from the Image API docs, read 2026-09-29.

What does Ideogram document?

Its page says character reference generations have special pricing, that it supports up to 1 character reference image for now, with optional grayscale masks, and that each image must be under 25MB with the request under 50MB. It also lists style types AUTO, GENERAL, REALISTIC, DESIGN and FICTION.

What can I send to ideogram/ideogram-v3 on Sume?

A parameter the catalog does not list is rejected with 400 unsupported_parameter, and provider.options must be empty in v1, so Ideogram-specific fields such as style type do not pass through.

How do I try a reference anyway?

Send the reference in input_references and say in the prompt what to keep. It is a general reference, not Ideogram's character reference feature, and results depend on the image.

curl -X POST https://api.sume.com/v1/images \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/ideogram-v3",
    "prompt": "The mascot from the reference holding a sign that says HELLO",
    "input_references": [
      {"type": "image_url", "image_url": {"url": "https://example.com/mascot.png"}}
    ],
    "quality": "medium"
  }'

Where do I get Ideogram's own character reference?

From Ideogram's API, on Ideogram's pricing. Sume's docs do not list it, so this post does not promise it.