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

Clé facultative fournie par l’utilisateur (jusqu’à 255 caractères). Si elle est définie, une réponse réussie (2xx) est mise en cache pendant 7 jours. Une nouvelle tentative avec la même clé et un corps de requête identique renvoie la réponse en cache (sans crédit supplémentaire facturé) ; une nouvelle tentative avec la même clé mais un corps différent renvoie 409. Permet de relancer un POST sans risque en cas d’erreur réseau. Pour les envois multipart/form-data, les requêtes sont comparées sur la base des champs du formulaire et du contenu des fichiers : un envoi relancé est donc bien rejoué même si le client choisit une nouvelle frontière multipart.

Idempotency-Key

URL publique de l’image source à étendre

image_url

Résolution cible au format `WIDTHxHEIGHT`. L’image sera étendue pour remplir cette taille. FLUX 2 Pro/Max acceptent aussi les préréglages de taille 1K/2K. Les requêtes surdimensionnées, 4K compris, sont réduites à environ 4MP au maximum (2048x2048 pour une image carrée) ; la sortie 4K native n’est pas prise en charge. La facturation se base sur la surface de sortie ajustée : jusqu’à 1,048,576 pixels au total, le prix 1K s’applique ; au-delà, c’est le prix 2K.

resolution

Modèle qui effectue le recadrage / l’outpainting. Par défaut : `nano_banana_2`. Les crédits suivent la grille modèle/résolution `image_reframe`.

| Modèle | Par défaut | 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 | - | - |

Les lignes GPT correspondent à la qualité medium. Les autres niveaux de qualité suivent la GPT Image Credit Matrix commune présentée plus haut.

model

Pour `gpt_image`, utilisez `low`, `medium`, `high` ou `auto`. Pour `gpt_image_2_5` (y compris Flare et Sunburst), `xhigh` et `max` sont également pris en charge. Si quality est omis ou vaut `auto`, le palier de facturation medium s’applique. Utilisez `resolution` pour indiquer les dimensions de sortie.

quality

image

Champ de fichier image source conservé pour compatibilité (obsolète : utilisez plutôt `image`).

file

URL de l’image source si aucune image n’est téléversée

code

message

image_urls

data

Le corps de la requête est mal formé ou des paramètres obligatoires sont manquants

La clé d’API est manquante, invalide ou révoquée

Le solde du compte est insuffisant ou l’abonnement a expiré

Le compte n’a pas accès à cet endpoint

Idempotency-Key réutilisée avec un corps de requête différent.

Limite de débit atteinte. Attendez le nombre de secondes indiqué dans l’en-tête `Retry-After` avant de réessayer.

Une erreur inattendue s’est produite sur le serveur

Étend une image à une nouvelle taille ou à un nouveau format en générant du contenu au-delà des bords d’origine.

Recadrer l'image

Entrée

Sortie

APIs associées