Generate a new photo
from one reference.

Optional prompt. Asynchronous tasks. One result per request.

Access and billing

Base URL: https://image-remix.run.place. Free access with unlimited cumulative generations. The website needs no sign-in; no balance or payment is required.

API requests still require a valid API key. Self-service sign-in and key creation are temporarily closed; use an existing key or contact the administrator.

Authorization: Bearer dp_YOUR_API_KEY

Download OpenAPI specification ↗

1. Submit an image

POST /v1/tasks

Send multipart/form-data. Required: image (JPEG, PNG, WebP; 20 MB maximum; at least 128 px per edge). Optional: prompt (up to 6000 characters) and reference_strength (0–1, default 0.72).

curl https://image-remix.run.place/v1/tasks \
  -H "Authorization: Bearer $IMAGE_API_KEY" \
  -H "Idempotency-Key: my-request-001" \
  -F "image=@reference.jpg" \
  -F "prompt=Keep the subject and setting, with natural variations in the details"

The prompt may be omitted or blank. Without an explicit size, the result keeps the original EXIF-oriented dimensions. A prompt may specify dimensions such as 1200x1600 or a ratio such as 3:4. Output edges: 128–16384 px; maximum 40 million pixels. The model samples about 0.8 megapixels and scales to the requested output dimensions.

An optional Idempotency-Key header avoids duplicate generation on retries. It accepts 1–128 letters, digits or _.:-. Reusing it with different inputs returns 409.

{"id":"TASK_ID","status":"queued","result":null}

Success returns HTTP 202 immediately. Generation continues asynchronously.

2. Poll and download

GET /v1/tasks/{task_id}

Poll every 3–5 seconds. States: queued → preparing → generating → finishing → completed, or failed. A completed task contains result.url, result.width and result.height. The signed URL expires after one hour; query again for a fresh URL. Anyone holding it can download that result until expiry, so keep it private.

curl https://image-remix.run.place/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $IMAGE_API_KEY"

GET /v1/tasks/{task_id}/result

Download the result as image/jpeg with your API key. Returns 409 until ready.

GET /v1/tasks?limit=20

List this API key’s tasks. Limit 1–50, default 20. Other customers’ tasks remain private.

Limits and errors

At most 3 active tasks per API key, 1 per website account/session, and 20 globally. One direct generation; no candidate screening or similarity checks. Around 10 seconds is a warm, unqueued optimization target, not a fixed guarantee. Loading, queueing and network transfer take additional time.

HTTP	Meaning
400 / 422	Invalid input
401	Missing or invalid key/login
403	Invalid/expired signed URL
404	Task absent or owned by someone else
409	Not ready or conflicting idempotency key
413	Upload too large
429	Too many active tasks or queue full

Errors use {"detail":"..."}. Review generated content before publishing.

Compare and share