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.
Pricing: $0.133/image. Endpoint:
POST /v1/models/openai/gpt-image-1.5/runs.Overview
- Endpoint: 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
Node.js
cURL
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 acallback_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-Idis always sent.Runflow-Signatureis sent if a signing secret is configured.
Additional Resources
Related
Browse all models
Browse the catalog.
Run lifecycle
Callbacks, polling, statuses.
Callbacks
Handle async results.
Pricing
How requests bill out.