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

Image Reframe 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/reframe' \
  -H 'Authorization: Bearer {codia_api_key}' \
  -F 'image=@./image.png' \
  -F 'resolution=1024x1024'
```

Outpaint / extend an image to fill a larger canvas at a specified target resolution — generate new pixels on the outside of the original frame rather than scaling it up. Synchronous.

## What this API is for

Converting square assets to wide banner formats, extending portraits into landscape, repurposing a 1:1 product photo as a 16:9 hero image. Different from `upscale` (which adds pixels *inside* the same crop) — `reframe` adds pixels *outside* it.

## Request

| Field | Required | Notes |
|---|---|---|
| `image_url` | yes | Public URL of the source. |
| `resolution` | yes | Requested target dimensions as `WIDTHxHEIGHT`, e.g. `1920x1080`. Actual output dimensions may be adjusted to the sizes supported by the selected model. |
| `model` | no | Default `nano_banana_2`. Also: `nano_banana_pro`, `flux_3`, `ideogram_v3`. |

If `resolution` matches the source's aspect ratio, the result is effectively an upscale (use `upscale` instead). The endpoint shines when the **aspect ratio changes** and net new pixels need to be hallucinated.

## Response

Shared `ImageUrlListSuccess` — one URL.

## Billing & limits

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

## Errors

Standard set; `400` on malformed `resolution`.

> **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_reframe` 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 zu erweiternden Quellbildes

image_url

Zielauflösung als `WIDTHxHEIGHT`. Das Bild wird so erweitert, dass es diese Größe ausfüllt. 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.

resolution

Modell, das das Reframing / Outpainting ausführt. Standard ist `nano_banana_2`. Die Credits richten sich nach der Modell-/Auflösungstabelle `image_reframe`.

| Modell | Standard | 1K | 2K | 4K |
| --- | ---: | ---: | ---: | ---: |
| `gpt_image` (medium) | 15 | 15 | 29 | 48 |
| `gpt_image_2_5` (medium) | 4 | 4 | 8 | 12 |
| `nano_banana_2` | 18 | 18 | 27 | 41 |
| `nano_banana_pro` | 36 | 36 | 36 | 65 |
| `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 |
| `flux_3` | 13 | 13 | 27 | 162 |
| `flux_2_pro` | 8 | 8 | 20 | - |
| `flux_2_max` | 19 | 19 | 43 | - |
| `ideogram_v3` | 16 | 16 | - | - |

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

model

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 `resolution` 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

Erweitert ein Bild auf eine neue Größe oder ein neues Seitenverhältnis, indem über die ursprünglichen Ränder hinaus neue Inhalte generiert werden.

Bild neu rahmen

Eingabe

Ausgabe

Ähnliche APIs