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

사용자가 지정하는 선택적 키(최대 255자). 설정하면 성공한(2xx) 응답이 7일 동안 캐시됩니다. 같은 키와 동일한 요청 본문으로 재시도하면 캐시된 응답이 반환되며 크레딧이 추가로 차감되지 않습니다. 같은 키로 다른 본문을 보내면 409가 반환됩니다. 네트워크 장애 시 POST를 안전하게 재시도할 수 있도록 하려면 이 키를 사용합니다. multipart/form-data 업로드는 폼 필드와 파일 내용으로 요청을 비교하므로, 클라이언트가 새 multipart boundary를 선택하더라도 재시도한 업로드에도 캐시된 응답이 반환됩니다.

Idempotency-Key

리프레임할 원본 이미지의 공개 URL

image_url

`WIDTHxHEIGHT` 형식의 목표 해상도. 이미지는 이 크기를 채우도록 확장됩니다. FLUX 2 Pro/Max는 1K/2K 크기 프리셋도 허용합니다. 4K를 포함해 너무 큰 요청은 최대 약 4MP(정사각형 이미지의 경우 2048x2048)로 축소되며, 네이티브 4K 출력은 지원되지 않습니다. 과금은 조정된 출력 면적을 기준으로 하며, 총 1,048,576픽셀 이하는 1K 가격이, 그보다 큰 출력은 2K 가격이 적용됩니다.

resolution

리프레임/아웃페인팅을 수행하는 모델. 기본값은 `nano_banana_2`입니다. 크레딧은 `image_reframe` 모델/해상도별 가격표를 따릅니다.

| 모델 | 기본값 | 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 | - | - |

GPT 행은 medium 품질 기준입니다. 다른 품질 등급은 위의 공통 GPT Image 크레딧 매트릭스를 따릅니다.

model

`gpt_image`에는 `low`, `medium`, `high`, `auto`를 사용합니다. `gpt_image_2_5`(Flare 및 Sunburst 포함)에서는 `xhigh`와 `max`도 지원됩니다. quality를 생략하거나 `auto`로 지정하면 medium 과금 구간이 적용됩니다. 출력 크기는 `resolution`으로 지정하십시오.

quality

image

호환용 원본 이미지 파일 필드(지원 중단: 대신 `image`를 사용하십시오).

file

이미지를 업로드하지 않을 때 사용하는 원본 이미지 URL

code

message

image_urls

data

요청 본문의 형식이 잘못되었거나 필수 매개변수가 누락되었습니다

API 키가 없거나, 유효하지 않거나, 폐기되었습니다

계정 잔액이 부족하거나 구독이 만료되었습니다

계정에 이 엔드포인트에 대한 액세스 권한이 없습니다

Idempotency-Key가 다른 요청 본문과 함께 재사용되었습니다.

속도 제한에 도달했습니다. `Retry-After` 헤더에 표시된 초만큼 기다린 후 재시도하십시오.

서버에서 예기치 않은 오류가 발생했습니다

원본 가장자리 바깥으로 새로운 콘텐츠를 생성하여 이미지를 새로운 크기나 종횡비로 확장합니다.

이미지 리프레임

입력

출력

관련 API