# GPT Image 2.5

> OpenAI GPT Image 2.5: photorealism, clean text, product shots and precise photo editing.

| Mode | ID | Price |
|---|---|---|
| [Image to Image](#image-to-image) | `gpt-image-2.5-image-to-image` | $0.02 |
| [Text to Image](#text-to-image) | `gpt-image-2.5-text-to-image` | $0.02 |

## Image to Image

Upload a photo and describe what to change. ID: `gpt-image-2.5-image-to-image` · $0.02 per image · ~2 min

**Parameters** (field `input`)

| Parameter | Required | Description | Values (default in bold) |
|---|---|---|---|
| `prompt` | yes | What to draw or what to change | text, up to 20000 chars |
| `input_urls` | yes | Links to your photos (https), up to 16 | `["https://…"]` |
| `aspect_ratio` | no | Image shape | **`auto`** `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `2:1` `1:2` `3:1` `1:3` `21:9` `9:21` `3:2` `2:3` |
| `resolution` | no | Quality: 1K is faster, 2K has more detail | **`1K`** |
| `background` | no | Background: `transparent` for no background | **`auto`** `opaque` `transparent` |

**Example**

```bash
curl -X POST https://ai.aimixmedia.site/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5-image-to-image","input":{"prompt":"Make the background a neon city at night","input_urls":["https://ai.aimixmedia.site/static/img/previews/gpt-t2i.jpg"],"aspect_ratio":"auto","resolution":"1K"}}'
```

```python
import os, requests

r = requests.post(
    "https://ai.aimixmedia.site/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "gpt-image-2.5-image-to-image",
      "input": {
        "prompt": "Make the background a neon city at night",
        "input_urls": [
          "https://ai.aimixmedia.site/static/img/previews/gpt-t2i.jpg"
        ],
        "aspect_ratio": "auto",
        "resolution": "1K"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://ai.aimixmedia.site/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "gpt-image-2.5-image-to-image",
    "input": {
      "prompt": "Make the background a neon city at night",
      "input_urls": [
        "https://ai.aimixmedia.site/static/img/previews/gpt-t2i.jpg"
      ],
      "aspect_ratio": "auto",
      "resolution": "1K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

## Text to Image

Describe the picture and the model creates it from scratch. ID: `gpt-image-2.5-text-to-image` · $0.02 per image · ~1.5 min

**Parameters** (field `input`)

| Parameter | Required | Description | Values (default in bold) |
|---|---|---|---|
| `prompt` | yes | What to draw or what to change | text, up to 20000 chars |
| `aspect_ratio` | no | Image shape | **`auto`** `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `2:1` `1:2` `3:1` `1:3` `21:9` `9:21` `3:2` `2:3` |
| `resolution` | no | Quality: 1K is faster, 2K has more detail | **`1K`** |
| `background` | no | Background: `transparent` for no background | **`auto`** `opaque` `transparent` |

**Example**

```bash
curl -X POST https://ai.aimixmedia.site/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5-text-to-image","input":{"prompt":"A cat astronaut in a neon city, cinematic light","aspect_ratio":"auto","resolution":"1K"}}'
```

```python
import os, requests

r = requests.post(
    "https://ai.aimixmedia.site/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "gpt-image-2.5-text-to-image",
      "input": {
        "prompt": "A cat astronaut in a neon city, cinematic light",
        "aspect_ratio": "auto",
        "resolution": "1K"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://ai.aimixmedia.site/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "gpt-image-2.5-text-to-image",
    "input": {
      "prompt": "A cat astronaut in a neon city, cinematic light",
      "aspect_ratio": "auto",
      "resolution": "1K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

## Result

Same as any task: call [recordInfo](https://docs.aimixmedia.site/en/endpoints/record-info) or receive a [callback](https://docs.aimixmedia.site/en/callbacks). Image links are in `resultJson` (kept for 30 days).

Upload your photos via [files/upload](https://docs.aimixmedia.site/en/endpoints/upload) or pass any public https links.