**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.

Optionaler, vom Client festgelegter Schlüssel (bis zu 255 Zeichen). Ist er gesetzt, wird eine erfolgreiche (2xx) Antwort 7 Tage lang zwischengespeichert. Eine Wiederholung mit demselben Schlüssel und identischem Request-Body liefert die gespeicherte Antwort (ohne zusätzliche Credits); eine Wiederholung mit demselben Schlüssel, aber anderem Body liefert 409. Damit lassen sich POST-Requests bei Netzwerkfehlern gefahrlos wiederholen. Bei multipart/form-data-Uploads werden Requests anhand der Formularfelder und Dateiinhalte verglichen, sodass ein wiederholter Upload auch dann als Wiederholung erkannt wird, wenn der Client eine neue Multipart-Boundary wählt.

Idempotency-Key

Öffentliche URL des Quellbildes für den Remix

image_url

Textbeschreibung des gewünschten Remix-Stils

prompt

Modell, das den Remix ausführt. Standard ist `nano_banana_2`. Die Credits richten sich nach der Modell-/Auflösungstabelle `image_remix`.

| Modell | Standard | 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 |

Die GPT-Zeilen zeigen die Qualitätsstufe medium. Für andere Qualitätsstufen gilt die gemeinsame GPT Image Credit Matrix oben.

model

Maße des Ausgabebildes als `WIDTHxHEIGHT`. FLUX 2 Pro/Max akzeptieren außerdem die Größenvorgaben 1K/2K. Zu große Anfragen, einschließlich 4K, werden auf höchstens etwa 4MP reduziert (2048x2048 bei quadratischen Bildern); native 4K-Ausgabe wird nicht unterstützt. Abgerechnet wird nach der angepassten Ausgabefläche: bis insgesamt 1,048,576 Pixel gilt der 1K-Preis, für größere Ausgaben der 2K-Preis. Eine explizite size hat Vorrang vor einem Auflösungshinweis in quality.

size

Für `gpt_image` verwenden Sie `low`, `medium`, `high` oder `auto`. Für `gpt_image_2_5` (einschließlich Flare und Sunburst) werden zusätzlich `xhigh` und `max` unterstützt. Ohne Angabe von quality oder mit `auto` gilt die Abrechnungsstufe medium. Geben Sie die Ausgabemaße mit `size` an.

quality

image

Kompatibilitätsfeld für die Quellbilddatei (veraltet: verwenden Sie stattdessen `image`).

file

URL des Quellbildes, wenn kein Bild hochgeladen wird

code

message

URLs der generierten oder verarbeiteten Bilder

image_urls

data

Der Request-Body ist fehlerhaft oder es fehlen erforderliche Parameter

Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen

Das Kontoguthaben reicht nicht aus oder das Abonnement ist abgelaufen

Das Konto hat keinen Zugriff auf diesen Endpunkt

Idempotency-Key mit einem anderen Request-Body wiederverwendet.

Rate-Limit erreicht. Warten Sie vor einem erneuten Versuch die im Header `Retry-After` angegebene Anzahl an Sekunden.

Auf dem Server ist ein unerwarteter Fehler aufgetreten

Erstellt ein neues Bild, das Komposition und Formen der Vorlage beibehält, sie aber anhand eines Prompts neu gestaltet.

Bild remixen

Eingabe

Ausgabe

Ähnliche APIs