> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 1.5

> GPT Image 1.5 generates high-fidelity images with strong prompt adherence, preserving composition, lighting, and fine-grained detail.

> [!NOTE]
>
> Pricing: **\$0.133/image**. Endpoint: `POST /v1/models/openai/gpt-image-1.5/runs`.

GPT Image 1.5 generates high-fidelity images with strong prompt adherence, preserving composition, lighting, and fine-grained detail.

## Overview

* **Endpoint**: [https://api.runflow.io/v1/models/openai/gpt-image-1.5/runs](https://api.runflow.io/v1/models/openai/gpt-image-1.5/runs)
* **Model ID**: openai/gpt-image-1.5
* **Provider**: OpenAI
* **License**: commercial
* **Last Updated**: 2026-04-13

## Pricing

* **Base price**: \$0.133/image
* **Note**: High quality (default)

# GPT Image 1.5 API

**Endpoint:** `POST /v1/models/openai/gpt-image-1.5/runs`

## Run the model

### Python

```python theme={"dark"}
import requests

response = requests.post(
    "https://api.runflow.io/v1/models/openai/gpt-image-1.5/runs",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "input": {
            "prompt": "An underwater coral reef tea house at the bottom of a crystal-clear tropical ocean. Bamboo replaced by swaying kelp and sea fans, fish swim where birds would fly, jellyfish provide the lantern light, a sea turtle approaches the entrance. Warm bioluminescent glow, caustic light patterns on the sandy floor."
        },
        "callback_url": "https://your-server.com/webhook"
    },
)

data = response.json()
print(data)
```

### Node.js

```javascript theme={"dark"}
const response = await fetch(
  "https://api.runflow.io/v1/models/openai/gpt-image-1.5/runs",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
        "input": {
            "prompt": "An underwater coral reef tea house at the bottom of a crystal-clear tropical ocean. Bamboo replaced by swaying kelp and sea fans, fish swim where birds would fly, jellyfish provide the lantern light, a sea turtle approaches the entrance. Warm bioluminescent glow, caustic light patterns on the sandy floor."
        },
        "callback_url": "https://your-server.com/webhook"
    }),
  }
);

const data = await response.json();
console.log(data);
```

### cURL

```bash theme={"dark"}
curl -X POST https://api.runflow.io/v1/models/openai/gpt-image-1.5/runs \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
    "input": {
        "prompt": "An underwater coral reef tea house at the bottom of a crystal-clear tropical ocean. Bamboo replaced by swaying kelp and sea fans, fish swim where birds would fly, jellyfish provide the lantern light, a sea turtle approaches the entrance. Warm bioluminescent glow, caustic light patterns on the sandy floor."
    },
    "callback_url": "https://your-server.com/webhook"
}
JSON
```

## Request parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `input` | object | required | Model input parameters. See "Input schema" below. |
| `callback_url` | string \| null | optional | Webhook URL - POSTed when the run reaches a terminal state. |
| `metadata` | object \| null | optional | Arbitrary key-value pairs attached to the run. |

## Input schema

| Field | Type | Required | Allowed values | Description |
| - | - | - | - | - |
| `prompt` | string | required | Any | Text prompt describing the image to generate. 2–32,000 characters. |
| `quality` | string | optional | `low`, `medium`, `high` | Output quality tier. Options: "low", "medium", "high". Default: "high". Affects price. |
| `image_size` | string | optional | `1024x1024`, `1536x1024`, `1024x1536` | Image dimensions. Options: "1024x1024", "1536x1024", "1024x1536", "auto". Default: "1024x1024". Use "auto" to let the model pick the best size. |
| `background` | string | optional | `auto`, `transparent`, `opaque` | Background type. Options: "auto", "transparent", "opaque". Default: "auto". |
| `num_images` | integer | optional | Any | Number of images to generate. Range: 1–4. Default: 1. |
| `output_format` | string | optional | `jpeg`, `png`, `webp` | Output format. Options: "jpeg", "png", "webp". Default: "png". |
| `sync_mode` | boolean | optional | Any | Return media as data URI without storing in history. Default: false. |

## Output schema

| Field | Type | Description |
| - | - | - |
| `outputs` | json | Unified output array - one entry per generated artifact with url/type/width/height/duration/etc. |
| `nsfw_detected` | json | true if the provider flagged output as NSFW, false if cleared, null if not checked. |
| `seed` | json | Deterministic seed used for generation, or null if the provider doesn't return one. |
| `timing` | json | Provider timing info (inference\_ms etc.), or null. |

## Callback payload

When you provide a `callback_url`, Runflow POSTs to it once the run reaches a terminal state.

| Field | Type | Description |
| - | - | - |
| `event` | string | Event type: "run.completed", "run.failed", or "run.cancelled". |
| `run_id` | string | The unique identifier of the run. |
| `status` | string | Terminal status: "succeeded", "failed", or "cancelled". |
| `output` | object \| null | The run output. Null if the run failed or was cancelled. |
| `duration_ms` | number \| null | Total run duration in milliseconds. |
| `created_at` | string \| null | ISO 8601 timestamp when the run was created. |
| `completed_at` | string \| null | ISO 8601 timestamp when the run reached terminal state. |
| `metadata` | object \| null | The metadata object passed at run creation, if any. |

* **Retries:** 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
* **Headers:** `Runflow-Request-Id` is always sent. `Runflow-Signature` is sent if a signing secret is configured.

## Additional Resources

* [Playground](https://app.runflow.io/models/openai/gpt-image-1.5)
* [API Reference](https://app.runflow.io/models/openai/gpt-image-1.5?tab=api)
* [Documentation](https://docs.runflow.io/index.md)
* [OpenAPI](https://docs.runflow.io/api/openapi.public.json)

## Related

> **[Browse all models](https://docs.runflow.io/models.md)**
>
> Browse the catalog.

> **[Run lifecycle](https://docs.runflow.io/concepts/runs.md)**
>
> Callbacks, polling, statuses.

> **[Callbacks](https://docs.runflow.io/concepts/callbacks.md)**
>
> Handle async results.

> **[Pricing](https://docs.runflow.io/concepts/pricing.md)**
>
> How requests bill out.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.