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

คีย์ที่ผู้ใช้กำหนดเอง (ไม่บังคับ ยาวสูงสุด 255 อักขระ) เมื่อกำหนดไว้ การตอบกลับที่สำเร็จ (2xx) จะถูกแคชไว้ 7 วัน การลองใหม่ด้วยคีย์เดิม + เนื้อหาคำขอที่เหมือนกันทุกประการจะได้การตอบกลับที่แคชไว้ (ไม่หักเครดิตเพิ่ม) ส่วนการลองใหม่ด้วยคีย์เดิมแต่เนื้อหาคำขอต่างกันจะได้ 409 ใช้เพื่อให้ส่ง POST ซ้ำได้อย่างปลอดภัยเมื่อเครือข่ายขัดข้อง สำหรับการอัปโหลดแบบ multipart/form-data ระบบจะเปรียบเทียบคำขอจากฟิลด์ในฟอร์มและเนื้อหาไฟล์ ดังนั้นการอัปโหลดซ้ำจะได้ผลลัพธ์เดิมแม้ไคลเอนต์จะสร้าง multipart boundary ใหม่

Idempotency-Key

URL สาธารณะของรูปภาพต้นฉบับที่จะรีมิกซ์

image_url

ข้อความอธิบายสไตล์รีมิกซ์ที่ต้องการ

prompt

โมเดลที่ใช้รีมิกซ์ ค่าเริ่มต้นคือ `nano_banana_2` เครดิตเป็นไปตามตารางโมเดล/ความละเอียดของ `image_remix`

| โมเดล | ค่าเริ่มต้น | 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 |

แถวของ GPT แสดงคุณภาพระดับ medium ระดับคุณภาพอื่นใช้ GPT Image Credit Matrix ที่ใช้ร่วมกันด้านบน

model

ขนาดรูปภาพเอาต์พุตในรูปแบบ `WIDTHxHEIGHT` FLUX 2 Pro/Max รองรับพรีเซ็ตขนาด 1K/2K ด้วย คำขอที่ใหญ่เกิน รวมถึง 4K จะถูกลดขนาดลงเหลือไม่เกินประมาณ 4MP (2048x2048 สำหรับภาพสี่เหลี่ยมจัตุรัส) ไม่รองรับเอาต์พุต 4K แบบเนทีฟ การคิดเงินใช้พื้นที่เอาต์พุตหลังปรับขนาดแล้ว: หากรวมไม่เกิน 1,048,576 พิกเซลจะคิดราคา 1K และเอาต์พุตที่ใหญ่กว่านั้นจะคิดราคา 2K ขนาดที่ระบุชัดเจนจะมีลำดับความสำคัญเหนือคำใบ้ความละเอียดใน quality

size

สำหรับ `gpt_image` ให้ใช้ `low`, `medium`, `high` หรือ `auto` สำหรับ `gpt_image_2_5` (รวมถึง Flare และ Sunburst) รองรับ `xhigh` และ `max` ด้วย หากไม่ระบุ quality หรือใช้ `auto` จะคิดเงินในระดับ medium ใช้ `size` เพื่อระบุขนาดเอาต์พุต

quality

ไฟล์รูปภาพต้นฉบับ

image

ฟิลด์ไฟล์รูปภาพต้นฉบับสำหรับความเข้ากันได้ (เลิกใช้แล้ว: ให้ใช้ `image` แทน)

file

URL รูปภาพต้นฉบับ เมื่อไม่ได้อัปโหลดรูปภาพ

prompt สำหรับรีมิกซ์

โมเดล (ไม่บังคับ)

URL ของรูปภาพที่ประมวลผลแล้ว

code

message

URL ของรูปภาพที่สร้างหรือประมวลผลแล้ว

image_urls

data

เนื้อหาคำขอมีรูปแบบไม่ถูกต้องหรือขาดพารามิเตอร์ที่จำเป็น

ไม่มี API key หรือ key ไม่ถูกต้องหรือถูกเพิกถอนแล้ว

ยอดคงเหลือในบัญชีไม่เพียงพอหรือการสมัครใช้งานหมดอายุแล้ว

บัญชีไม่มีสิทธิ์เข้าถึง endpoint นี้

ใช้ Idempotency-Key ซ้ำกับเนื้อหาคำขอที่ต่างออกไป

ถูกจำกัดอัตราการเรียกใช้ (rate limit) ให้รอตามจำนวนวินาทีในเฮดเดอร์ `Retry-After` ก่อนลองใหม่

เกิดข้อผิดพลาดที่ไม่คาดคิดบนเซิร์ฟเวอร์

สร้างภาพใหม่ที่คงองค์ประกอบและรูปทรงของภาพต้นฉบับไว้ แต่เปลี่ยนสไตล์ตาม prompt

รีมิกซ์รูปภาพ

อินพุต

เอาต์พุต

API ที่เกี่ยวข้อง