GPT Image 2.5 400 unsupported_parameter: fields each model accepts
A 400 unsupported_parameter from Sume's image API means the model does not list that field. Which GPT Image ids accept quality, mask_url and background.

A 400 unsupported_parameter from POST /v1/images means you sent a field that the selected model does not list in its catalog. Sume rejects it instead of dropping it silently. For the GPT Image family, the usual causes are mask_url or background sent to openai/gpt-image-2, or output_compression and seed, which no model advertises yet.
Facts are from Sume's Image API docs, read 2026-09-29.
Which GPT Image fields does each model list?
| Field | `openai/gpt-image-2` | `openai/gpt-image-2.5` / `-sunburst` |
|---|---|---|
mask_url | Rejected | Accepted |
background | Rejected | Accepted |
quality xhigh, max, auto | Rejected | Accepted |
output_compression | Rejected | Rejected |
seed | Rejected | Rejected |
stream: true | 400 streaming_not_supported | 400 streaming_not_supported |
How do I see what a model accepts before I call?
Read its endpoint record. supported_parameters there is the definitive set, and model-level and endpoint-level sets are identical because Sume serves each model through one sume endpoint.
curl "https://api.sume.com/v1/images/models/openai/gpt-image-2.5/endpoints" \
-H "Authorization: Bearer $SUME_API_KEY"What about output_format svg or provider options?
The docs list png, jpeg, webp or svg as schema values, but the catalog is the authority for a model: check output_format in its descriptor. provider.options must be omitted or empty, since allowed_passthrough_parameters is empty for every endpoint in v1.
Sources
Related posts
More in Developers
- Grok 4.7 remote MCP tool: connect Sume to the xAI Responses API
xAI's remote MCP tool works with grok-4.7 on the Responses API. Point server_url at Sume's hosted MCP, restrict allowed_tools, and cap spend on the Sume side.
- HeyGen API avatar ID and voice ID: where to find them
In HeyGen's v3 API, avatar_id is a look id from GET /v3/avatars/looks, and voice_id comes from GET /v3/voices or the look's default voice.
- HeyGen API key: get one and make your first video
Generate a HeyGen API key in its API dashboard, send it as X-Api-Key to api.heygen.com, check it with GET /v3/users/me, then create a video.
- HeyGen API v2 retirement: the date and the v3 endpoints
HeyGen's API v1 and v2 stay operational until October 31, 2026 and retire on November 1. The warning headers, and the v3 call for each v2 call.
Written by Sume