**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 للصورة المصدر عند عدم رفع صورة

روابط URL للصور المعالَجة

code

message

روابط URL للصور المُولَّدة أو المعالَجة

image_urls

data

جسم الطلب غير صالح أو تنقصه معاملات مطلوبة

مفتاح API مفقود أو غير صالح أو تم إبطاله

رصيد الحساب غير كافٍ أو انتهت صلاحية الاشتراك

لا يملك الحساب صلاحية الوصول إلى نقطة النهاية هذه

أُعيد استخدام Idempotency-Key مع جسم طلب مختلف.

تم تجاوز حد المعدل. انتظر عدد الثواني المحدد في الترويسة `Retry-After` قبل إعادة المحاولة.

حدث خطأ غير متوقع في الخادم

يُنشئ صورة جديدة تحافظ على تكوين الصورة المصدر وأشكالها مع إعادة تصميم أسلوبها وفق prompt.

إعادة مزج الصورة

المدخلات

المخرجات

واجهات API ذات صلة