Ideogram color_palette parameter: brand colours in Sume prompts

Ideogram's API takes a color_palette parameter. The Sume image API has no palette field, so brand colours go in the prompt and a reference swatch image.

4 min readSume
All posts

Ideogram's Generate 3.0 reference lists an optional color_palette parameter. The Sume image API has no such field: its request schema (see the Image API docs) carries model, prompt, n, resolution, aspect_ratio, quality, output_format, mask_url, background, input_references and a few routing and job fields. A request that sets a parameter the model does not list is rejected with 400 unsupported_parameter. Brand colours therefore travel in the prompt, backed by a swatch reference image.

What the vendor page says

From the Ideogram API reference, read on the date below.

Ideogram color_palette facts, read 2026-10-02
ParameterWhat the page says
color_paletteOptional; typed as a palette given either by preset name or by members.
negative_promptDescription of what to exclude; descriptions in the prompt take precedence.

Do not send it

Copying an Ideogram body that includes color_palette into a Sume request will fail by design. Catalog descriptors are the definitive list, and allowed_passthrough_parameters is empty for every endpoint in v1, so provider.options cannot smuggle it through either.

Two substitutes that work

Combine both for the strongest pull:

  • Name the colours in the prompt with hex codes and roles, for example "background #F4EDE4, accent #1F6F5C, text near-black".
  • Send a plain swatch image as an input_references entry and say "use only the colours in image 1". Models that list input_references with a max above 0 accept it.

Make the swatch from the brand file

A swatch needs no design tool. This script writes a PNG of equal colour bands; upload it anywhere public over HTTPS, then reference it.

from PIL import Image, ImageDraw

colors = ["#F4EDE4", "#1F6F5C", "#E2A33B", "#222222"]
w, h = 256, 256
img = Image.new("RGB", (w * len(colors), h))
d = ImageDraw.Draw(img)
for i, c in enumerate(colors):
    d.rectangle([i * w, 0, (i + 1) * w, h], fill=c)
img.save("swatch.png")
print("saved swatch.png")

Check the result

Colour adherence is a soft control. Sample the output with an eyedropper or a script, and if a colour drifts, shorten the palette to three. Because there is no seed, repeat the prompt once before blaming the wording.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume