Skip to main content

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.
GPT Image 1.5 generates high-fidelity images with strong prompt adherence, preserving composition, lighting, and fine-grained detail.

Overview

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

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

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

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

ParameterTypeRequiredDescription
inputobjectrequiredModel input parameters. See “Input schema” below.
callback_urlstring | nulloptionalWebhook URL - POSTed when the run reaches a terminal state.
metadataobject | nulloptionalArbitrary key-value pairs attached to the run.

Input schema

FieldTypeRequiredAllowed valuesDescription
promptstringrequiredAnyText prompt describing the image to generate. 2–32,000 characters.
qualitystringoptionallow, medium, highOutput quality tier. Options: “low”, “medium”, “high”. Default: “high”. Affects price.
image_sizestringoptional1024x1024, 1536x1024, 1024x1536Image dimensions. Options: “1024x1024”, “1536x1024”, “1024x1536”, “auto”. Default: “1024x1024”. Use “auto” to let the model pick the best size.
backgroundstringoptionalauto, transparent, opaqueBackground type. Options: “auto”, “transparent”, “opaque”. Default: “auto”.
num_imagesintegeroptionalAnyNumber of images to generate. Range: 1–4. Default: 1.
output_formatstringoptionaljpeg, png, webpOutput format. Options: “jpeg”, “png”, “webp”. Default: “png”.
sync_modebooleanoptionalAnyReturn media as data URI without storing in history. Default: false.

Output schema

FieldTypeDescription
outputsjsonUnified output array - one entry per generated artifact with url/type/width/height/duration/etc.
nsfw_detectedjsontrue if the provider flagged output as NSFW, false if cleared, null if not checked.
seedjsonDeterministic seed used for generation, or null if the provider doesn’t return one.
timingjsonProvider 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.
FieldTypeDescription
eventstringEvent type: “run.completed”, “run.failed”, or “run.cancelled”.
run_idstringThe unique identifier of the run.
statusstringTerminal status: “succeeded”, “failed”, or “cancelled”.
outputobject | nullThe run output. Null if the run failed or was cancelled.
duration_msnumber | nullTotal run duration in milliseconds.
created_atstring | nullISO 8601 timestamp when the run was created.
completed_atstring | nullISO 8601 timestamp when the run reached terminal state.
metadataobject | nullThe 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

Browse all models

Browse the catalog.

Run lifecycle

Callbacks, polling, statuses.

Callbacks

Handle async results.

Pricing

How requests bill out.