**Cost**: Model-priced per successful call. See the Credit Matrix for `image_remix` model and resolution prices.

Image Remix supports two input modes:

1. **JSON URL mode**: send `application/json` with the existing URL field.
2. **Direct upload mode**: send `multipart/form-data` with a local image file in the `image` field. The compatible field name `file` is also accepted for the primary image. Codia checks credits before reading and uploading the file, so insufficient-credit requests return `402` without uploading anything.

Direct upload example:

```bash
curl 'https://openapi.codia.ai/v2/open/image/remix' \
  -H 'Authorization: Bearer {codia_api_key}' \
  -F 'image=@./image.png' \
  -F 'prompt=turn into pixel art' \
  -F 'size=1024x1024'
```

Generate a new image that **preserves the structure** of a source (composition, layout, pose, key shapes) while changing the rest according to a prompt. Stronger structural preservation than `image_to_image` — use this when the silhouette / framing matters and only the surface should change.

## What this API is for

Thumbnail variants that keep the same crop; alternate color schemes for the same composition; style variants for marketing across regions; iterating on a moodboard image.

## Request

| Field | Required | Notes |
|---|---|---|
| `image_url` | yes | Public URL of the source. |
| `prompt` | yes | Description of the desired remix. |
| `model` | no | Default `nano_banana_2`. Also: `nano_banana_pro`, `flux_3`, `ideogram_v4`. |
| `size` | no | Output dimensions as `WIDTHxHEIGHT`. If omitted, output matches the source's aspect. |

## Response

Shared `ImageUrlListSuccess` — one URL in `data.image_urls`.

## Billing & limits

- Credits follow the `image_remix` model/resolution table in the global Credit Matrix.
- Synchronous.

## Errors

Standard set.

> **Sync vs. async**
> This synchronous endpoint returns the result inline — the simplest path. For production pipelines that need webhook delivery, automatic retry with idempotency, or explicit task cancellation, call `POST /v2/open/tasks` with `operation=image_remix` instead. Inputs and credit cost are identical.

Clave opcional proporcionada por el usuario (hasta 255 caracteres). Si se indica, una respuesta correcta (2xx) se guarda en caché durante 7 días. Un reintento con la misma clave y un cuerpo de solicitud idéntico devuelve la respuesta en caché (sin cobrar créditos adicionales); un reintento con la misma clave pero un cuerpo distinto devuelve 409. Úsala para que reintentar un POST tras un fallo de red sea seguro. En las subidas multipart/form-data, las solicitudes se comparan por los campos del formulario y el contenido de los archivos, de modo que una subida reintentada se reproduce aunque el cliente elija un nuevo boundary multipart.

Idempotency-Key

URL pública de la imagen de origen que se va a remezclar

image_url

Descripción en texto del estilo de remix que quieres

prompt

Modelo que realiza el remix. El valor predeterminado es `nano_banana_2`. Los créditos siguen la tabla de modelo/resolución de `image_remix`.

| Modelo | Predeterminado | 1K | 2K | 4K |
| --- | ---: | ---: | ---: | ---: |
| `nano_banana_2` | 18 | 18 | 27 | 41 |
| `nano_banana_pro` | 36 | 36 | 36 | 65 |
| `gpt_image` (medium) | 15 | 15 | 29 | 48 |
| `gpt_image_2_5` (medium) | 4 | 4 | 8 | 12 |
| `seedream_5_pro` | 12 | 12 | 24 | - |
| `seedream_5_flash` | 5 | 5 | 5 | - |
| `seedream_5` | 10 | 10 | 10 | 10 |
| `seedream_4_5` | 11 | 11 | 11 | 11 |
| `recraft_v4` | 11 | 11 | 11 | - |
| `flux_3` | 13 | 13 | 27 | 162 |
| `flux_2_pro` | 8 | 8 | 20 | - |
| `flux_2_max` | 19 | 19 | 43 | - |
| `ideogram_v4` | 16 | 16 | 16 | 16 |

Las filas de GPT muestran la calidad medium. Los demás niveles de calidad usan la matriz de créditos de GPT Image compartida que aparece más arriba.

model

Dimensiones de la imagen de salida en formato `WIDTHxHEIGHT`. FLUX 2 Pro/Max también aceptan los preajustes de tamaño 1K/2K. Las solicitudes demasiado grandes, incluidas las de 4K, se reducen a un máximo aproximado de 4MP (2048x2048 para imágenes cuadradas); no se admite la salida 4K nativa. La facturación usa el área de salida ajustada: hasta 1,048,576 píxeles en total se aplica el precio de 1K, y las salidas más grandes usan el precio de 2K. Un size explícito tiene prioridad sobre una indicación de resolución en quality.

size

Para `gpt_image`, usa `low`, `medium`, `high` o `auto`. Para `gpt_image_2_5` (incluidos Flare y Sunburst), también se admiten `xhigh` y `max`. Si se omite quality o se usa `auto`, se aplica el tramo de facturación medium. Usa `size` para especificar las dimensiones de salida.

quality

image

Campo compatible para el archivo de imagen de origen (obsoleto: usa `image` en su lugar).

file

URL de la imagen de origen si no se sube la imagen

code

message

URL de las imágenes generadas o procesadas

image_urls

data

El cuerpo de la solicitud tiene un formato incorrecto o le faltan parámetros obligatorios

Falta la clave de API, no es válida o se ha revocado

El saldo de la cuenta es insuficiente o la suscripción ha caducado

La cuenta no tiene acceso a este endpoint

Idempotency-Key reutilizada con un cuerpo de solicitud distinto.

Límite de frecuencia alcanzado. Espera el número de segundos indicado en el encabezado `Retry-After` antes de reintentar.

Se ha producido un error inesperado en el servidor

Crea una imagen nueva que mantiene la composición y las formas de la original, pero cambia su estilo según un prompt.

Remezclar imagen

Entrada

Salida

APIs relacionadas