Use the GPT Image 2.5 API via RunAPI with a model skill, unified auth, and pay-as-you-go pricing.
curl -X POST https://runapi.ai/api/v1/gpt_image_2_5/edit_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-sunburst",
"source_image_urls": [
"https://cdn.runapi.ai/public/samples/image.jpg"
],
"prompt": "Generate a 4K product hero image of a matte-black water bottle on a beige stone surface, soft side light."
}'import { GptImage25Client } from "@runapi.ai/gpt-image-2-5";
const client = new GptImage25Client();
const result = await client.editImage.run({
model: "gpt-image-2.5-sunburst",
source_image_urls: ["https://cdn.runapi.ai/public/samples/image.jpg"],
prompt: "Generate a 4K product hero image of a matte-black water bottle on a beige stone surface, soft side light.",
});require "runapi/gpt_image_2_5"
client = RunApi::GptImage25::Client.new
result = client.edit_image.run(
model: "gpt-image-2.5-sunburst",
source_image_urls: ["https://cdn.runapi.ai/public/samples/image.jpg"],
prompt: "Generate a 4K product hero image of a matte-black water bottle on a beige stone surface, soft side light."
)npx skills add runapi-ai/gpt-image-2.5 -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorThe GPT Image 2.5 API delivers a strong quality-to-cost ratio in the image space. Multiple variants let you pick the tier that matches your latency, quality, and budget targets — start on a fast or lite variant for prototyping, then graduate to pro or max for production. Install the GPT Image 2.5 skill to bring docs, typed schemas, pricing notes, and step-by-step setup into your coding workspace. The skill works with Claude Code, Codex, Gemini CLI, Cursor, and VS Code, so your agent has the right context before you write integration code. All variants share a single RunAPI API key, unified billing in USD, and the same async task lifecycle — submit, poll or stream, and receive results via webhook callback.
| Endpoint | Resolution | Duration | Price | |
|---|---|---|---|---|
| text_to_image | 1k, 2k, 4k | — | $0.06-$0.16 / image | |
| edit_image | 1k, 2k, 4k | — | $0.16 / image |
Prices shown for gpt-image-2.5-flare. Other variants retain their own endpoint pricing.
Sign up and generate an API key from the dashboard.
Choose the version that best matches your quality and cost requirements.
Submit your prompt and parameters to the model's documented endpoint.
Poll the task or set a webhook, then download the completed output.
The GPT Image 2.5 API exposes a image model from OpenAI, accessible through RunAPI with a single API key and per-call billing. Developers call GPT Image 2.5 the same way they call any other model in the RunAPI catalog — set the model parameter, submit a request, and receive structured JSON. The model skill packages docs, typed schemas, pricing notes, and setup steps so your coding agent has the right context before you write integration code. Billing is unified across all providers, failed generations are never charged, and results are retrievable by task ID.
A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter.
Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model.
Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code.
GPT Image 2.5 Flare and GPT Image 2.5 Sunburst are available for text-to-image generation and image editing through the same API format.
Choose 1K, 2K, or 4K output resolution for text-to-image and image editing requests.
Yes. Send one or more source image URLs with an editing prompt to create an updated image.
Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production.
Creating an account and API key is free. API calls use prepaid, pay-as-you-go billing; add funds before making requests.
Where streaming is available, RunAPI streams end-to-end.