GPT Image 2 Pro Image-to-Image

POST /v1/tasks

All models are called through the Unified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	gpt-image-2-image-to-image-pro
Type	Image generation (image-to-image Pro)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

GPT Image 2 Pro Image-to-Image edits, redraws, and upgrades visuals from 1-5 reference images, with up to 2K output.

Production guidance

For production, pass callback.url at the top level of the request body so HiAPI can notify your service when the task reaches a terminal state.
GET /v1/tasks/:id is better for local debugging, low-volume jobs, or fallback reconciliation if a callback is missed.
Use callback.when=final. Both success and fail are terminal states, so your service should deduplicate by taskId.

Best suited for

Reference refinement

Use product, portrait, or source images as references for commercial redraws.

input_urlsprompt

Multi-reference work

Pass up to 5 reference images when subject, style, and scene should come from separate sources.

input_urls

Product visual upgrade

Turn rough source assets into cleaner commerce or brand visuals.

promptresolution

Ratio reconstruction

Keep the key subject from the reference while producing a target placement ratio.

aspect_ratio

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-image-to-image-pro",
  "input": {
    "prompt": "Restyle the reference into a premium product campaign image with clean typography",
    "input_urls": [
      "https://example.com/reference.png"
    ],
    "aspect_ratio": "4:5",
    "resolution": "2K"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "gpt-image-2-image-to-image-pro",
  "input": {
    "prompt": "Restyle the reference into a premium product campaign image with clean typography",
    "input_urls": [
      "https://example.com/reference.png"
    ],
    "aspect_ratio": "4:5",
    "resolution": "2K"
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-2-image-to-image-pro",
  "input": {
    "prompt": "Restyle the reference into a premium product campaign image with clean typography",
    "input_urls": [
      "https://example.com/reference.png"
    ],
    "aspect_ratio": "4:5",
    "resolution": "2K"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value gpt-image-2-image-to-image-pro.

example gpt-image-2-image-to-image-pro

input object required

Business parameters for reference image URLs, edit instructions, and output settings.

prompt string required

Edit or redraw instruction, up to 20000 characters.

input_urls string[] required

Reference image URL array. Minimum 1 image, maximum 5 images.

aspect_ratio enum optional

Output image aspect ratio.

default auto enum: auto1:12:33:23:44:34:55:49:1616:921:9

resolution enum optional

Output resolution tier.

default 1K enum: 1K2K

callback object optional

Optional callback configuration. In production, pass callback.url so HiAPI can notify your service when the task reaches a terminal state.

url string required

HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final for terminal-state notifications.

default final enum: final

Example requests

Commercial redraw from a reference

Upgrade a reference into a polished product visual.

Request body

{
  "model": "gpt-image-2-image-to-image-pro",
  "input": {
    "prompt": "Restyle the reference into a premium product campaign image with clean typography, soft studio lighting",
    "input_urls": [
      "https://example.com/reference.png"
    ],
    "aspect_ratio": "4:5",
    "resolution": "2K"
  }
}

Multi-reference request

Pass up to 5 reference images and explain how each should be used.