Image 1.0
Sume will retire this model soon. Image 1.0 is a compatibility alias for Image Router Auto.
For new integrations, use POST /v1/images with model: "sume/auto".
The URLs below continue to accept their legacy request shape, which includes
avatar references and transparency. But these URLs use the same Auto model
selection and return job.model: "sume/auto".
Primary invoke URL:
Model-run alias (same body):
The public model id is sume/image-1.0.
When to use
| Goal | Approach |
|---|---|
| Text → image | prompt only |
| Edit / reference | prompt + image_urls (1–10 public HTTPS URLs) |
| Masked edit | add mask_image_url with image_urls |
Use only public HTTPS image URLs. Sume rejects localhost, private-network, and non-HTTPS URLs before submission.
Request fields
| Field | Required | Notes |
|---|---|---|
prompt | Yes | Non-empty string. |
image_urls | No | 1–10 reference/edit image URLs. Use this field, not the deprecated input_urls. |
mask_image_url | No | Mask image URL for edit flows. |
aspect_ratio | No | Per-model native catalog. 4:5 is Instagram portrait (1080×1350), not 4:3. gpt-image-2 also accepts 5:4 / 9:8 / 4:5. Custom-pixel models ignore this field when image_size is set. |
image_size | No | Named presets or { width, height } / WIDTHxHEIGHT on models that accept custom pixels (GPT, Seedream, Flux, Qwen, Recraft). GPT custom: both edges ×16, max edge 3840, aspect ≤3:1, 655,360–8,294,400. On Nano Banana, WxH maps to the native aspect_ratio (1080×1350 → 4:5). Exact pixels come from a documented post-step through job target_pixels. |
quality | No | low (default), medium, high. Use a higher value for finals, dense text, or packaging. |
num_images | No | Integer 1–4. Use this field, not the deprecated n. |
output_format | No | png, jpeg, jpg, webp. Use this field, not the deprecated format. |
metadata | No | Caller metadata that Sume stores on the job. Sume does not send it to the provider. |
mode | No | async (default behavior on most clients when you omit the field), sync, subscribe, webhook. |
webhook_url | No | Public HTTPS callback for terminal delivery when you use webhook mode. |
wait_timeout_seconds | No | 0–30. Maximum time that sync / subscribe waits before it returns. |
Sume still accepts these deprecated aliases: input_urls, n, format. Use
the non-deprecated names above.
Create an image job
Generate an Image 1.0 job
POST /v1/image-1.0/generate
Required
Reference / edit example:
When you retry after a client timeout, use the same Idempotency-Key again
only for the same operation and payload. Refer to
Jobs and results.
Poll and fetch the result
Submit responses include status_url, result_url, events_url, and optional
cancel_url. Poll until the job is terminal. Then fetch the result.
Artifacts
Completed Image 1.0 jobs return Sume-hosted media under result.artifacts[]:
Use the returned Sume media URLs. Raw provider URLs are not part of the public result contract.
Next
- Video 1.0 for motion from prompts or first frames
- Jobs and results for modes, cancellation, and events
- Media inputs for HTTPS URL rules
- Recipes for short copy-paste flows