# GPT Image 2.6 Sunburst API

OpenAI GPT Image 2.6 Sunburst: refined, higher-quality output with greater consistency across edits.

Base URL: https://01router.com/api/v1
Model ID: gpt-image-2.6-sunburst
Documentation: https://01router.com/gateway/gpt-image-2.6-sunburst#api

## Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

```bash
export API_KEY="YOUR_API_KEY"
curl "https://01router.com/api/v1/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "gpt-image-2.6-sunburst",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  }
}
JSON
```

## Endpoints

| Method | Path | Authentication | Description |
| --- | --- | --- | --- |
| POST | /api/v1/generations | API key required | Create a generation (charges credits) |
| GET | /api/v1/generations/{id} | API key required | Get a generation; polls the provider while running |
| POST | /api/v1/generations/{id}/cancel | API key required | Cancel a running generation (credits refunded) |
| POST | /api/v1/quote | Public · no key | Price a request on every provider (no charge, no key needed) |
| POST | /api/v1/images/generations | API key required | OpenAI-compatible image generation (waits for the result) |
| GET | /api/v1/prompts?model=gpt-image-2.6-sunburst&locale=en&page=1 | Public · no key | Prompt list, model categories and filters |
| GET | /api/v1/prompts/{id} | Public · no key | Prompt details |
| GET | /api/v1/models/gpt-image-2.6-sunburst | Public · no key | Get one model |

## Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

`Authorization: Bearer <API_KEY>`

## Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| model | string | Yes | "gpt-image-2.6-sunburst" |
| provider | string | No | Pin a provider; omit to auto-route to the cheapest. One of: fal \| replicate \| wavespeed \| kie \| vercel |
| input | object | Yes | Model parameters, see the input fields below. |
| callback_url | string | No | Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available. |

### input

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

| Name | Type | Required | Description | Default |
| --- | --- | --- | --- | --- |
| input.prompt | string | Yes | Prompt | — |
| input.image_urls | string[] | No | Optional — switches to image editing; maxItems: 10 | — |
| input.mask_url | string | No | White areas are edited, black kept; needs an input image | — |
| input.background | string | No | Background; options: ["auto","transparent","opaque"] | — |
| input.aspect_ratio | string | No | Aspect ratio; options: ["1:1","4:3","3:4","16:9","9:16","3:2","2:3"] | "1:1" |
| input.quality | string | No | Quality; options: ["low","medium","high","xhigh","max"] | "medium" |
| input.num_images | integer | No | Images; min: 1; max: 4 | 1 |

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

### Provider parameters, prices and billing

```json
[
  {
    "provider": "fal",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_urls",
        "type": "images",
        "label": "Reference images",
        "description": "Optional — switches to image editing",
        "maxItems": 10
      },
      {
        "name": "mask_url",
        "type": "image",
        "label": "Mask",
        "description": "White areas are edited, black kept; needs an input image"
      },
      {
        "name": "background",
        "type": "enum",
        "label": "Background",
        "options": [
          "auto",
          "transparent",
          "opaque"
        ]
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "1:1",
          "4:3",
          "3:4",
          "16:9",
          "9:16",
          "3:2",
          "2:3"
        ],
        "default": "1:1"
      },
      {
        "name": "quality",
        "type": "enum",
        "label": "Quality",
        "options": [
          "low",
          "medium",
          "high",
          "xhigh",
          "max"
        ],
        "default": "medium"
      },
      {
        "name": "num_images",
        "type": "integer",
        "label": "Images",
        "min": 1,
        "max": 4,
        "default": 1
      }
    ],
    "prices": [
      {
        "unit": "image",
        "conditions": {
          "quality": "low"
        },
        "priceMicros": 23456,
        "originalMicros": 24690,
        "credits": 3,
        "itemFeeUnits": {
          "image_urls": 1.012555690562981,
          "mask_url": 1.012555690562981
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "medium"
        },
        "priceMicros": 41297,
        "originalMicros": 43470,
        "credits": 5,
        "itemFeeUnits": {
          "image_urls": 0.5751092707614447,
          "mask_url": 0.5751092707614447
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "high"
        },
        "priceMicros": 50046,
        "originalMicros": 52680,
        "credits": 6,
        "itemFeeUnits": {
          "image_urls": 0.4745634016704632,
          "mask_url": 0.4745634016704632
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "xhigh"
        },
        "priceMicros": 88977,
        "originalMicros": 93660,
        "credits": 9,
        "itemFeeUnits": {
          "image_urls": 0.266922912662823,
          "mask_url": 0.266922912662823
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "max"
        },
        "priceMicros": 200184,
        "originalMicros": 210720,
        "credits": 21,
        "itemFeeUnits": {
          "image_urls": 0.1186408504176158,
          "mask_url": 0.1186408504176158
        }
      }
    ],
    "billing": {
      "version": 1,
      "priceScope": "gateway",
      "creditsPerUsd": 100,
      "modelParams": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt",
          "required": true
        },
        {
          "name": "image_urls",
          "type": "images",
          "label": "Reference images",
          "description": "Optional — switches to image editing",
          "maxItems": 10
        },
        {
          "name": "mask_url",
          "type": "image",
          "label": "Mask",
          "description": "White areas are edited, black kept; needs an input image"
        },
        {
          "name": "background",
          "type": "enum",
          "label": "Background",
          "options": [
            "auto",
            "transparent",
            "opaque"
          ]
        },
        {
          "name": "aspect_ratio",
          "type": "enum",
          "label": "Aspect ratio",
          "options": [
            "1:1",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "3:2",
            "2:3"
          ],
          "default": "1:1"
        },
        {
          "name": "quality",
          "type": "enum",
          "label": "Quality",
          "options": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ],
          "default": "medium"
        },
        {
          "name": "num_images",
          "type": "integer",
          "label": "Images",
          "min": 1,
          "max": 4,
          "default": 1
        }
      ],
      "videoFirstOnly": false,
      "videoRoutes": [],
      "itemFees": {
        "image_urls": {
          "usd": 0.025
        },
        "mask_url": {
          "usd": 0.025
        }
      }
    }
  },
  {
    "provider": "replicate",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_urls",
        "type": "images",
        "label": "Reference images",
        "description": "Optional — switches to image editing",
        "maxItems": 10
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "1:1",
          "4:3",
          "3:4",
          "16:9",
          "9:16",
          "3:2",
          "2:3"
        ],
        "default": "1:1"
      },
      {
        "name": "quality",
        "type": "enum",
        "label": "Quality",
        "options": [
          "low",
          "medium",
          "high",
          "xhigh",
          "max"
        ],
        "default": "medium"
      },
      {
        "name": "num_images",
        "type": "integer",
        "label": "Images",
        "min": 1,
        "max": 4,
        "default": 1
      }
    ],
    "prices": [
      {
        "unit": "image",
        "conditions": {
          "quality": "low"
        },
        "priceMicros": 47500,
        "originalMicros": 50000,
        "credits": 5
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "medium"
        },
        "priceMicros": 85500,
        "originalMicros": 90000,
        "credits": 9
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "high"
        },
        "priceMicros": 121600,
        "originalMicros": 128000,
        "credits": 13
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "xhigh"
        },
        "priceMicros": 237500,
        "originalMicros": 250000,
        "credits": 24
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "max"
        },
        "priceMicros": 475000,
        "originalMicros": 500000,
        "credits": 48
      }
    ],
    "billing": {
      "version": 1,
      "priceScope": "gateway",
      "creditsPerUsd": 100,
      "modelParams": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt",
          "required": true
        },
        {
          "name": "image_urls",
          "type": "images",
          "label": "Reference images",
          "description": "Optional — switches to image editing",
          "maxItems": 10
        },
        {
          "name": "mask_url",
          "type": "image",
          "label": "Mask",
          "description": "White areas are edited, black kept; needs an input image"
        },
        {
          "name": "background",
          "type": "enum",
          "label": "Background",
          "options": [
            "auto",
            "transparent",
            "opaque"
          ]
        },
        {
          "name": "aspect_ratio",
          "type": "enum",
          "label": "Aspect ratio",
          "options": [
            "1:1",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "3:2",
            "2:3"
          ],
          "default": "1:1"
        },
        {
          "name": "quality",
          "type": "enum",
          "label": "Quality",
          "options": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ],
          "default": "medium"
        },
        {
          "name": "num_images",
          "type": "integer",
          "label": "Images",
          "min": 1,
          "max": 4,
          "default": 1
        }
      ],
      "videoFirstOnly": false,
      "videoRoutes": []
    }
  },
  {
    "provider": "wavespeed",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_urls",
        "type": "images",
        "label": "Reference images",
        "description": "Optional — switches to image editing",
        "maxItems": 10
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "1:1",
          "4:3",
          "3:4",
          "16:9",
          "9:16",
          "3:2",
          "2:3"
        ],
        "default": "1:1"
      },
      {
        "name": "quality",
        "type": "enum",
        "label": "Quality",
        "options": [
          "low",
          "medium",
          "high",
          "xhigh",
          "max"
        ],
        "default": "medium"
      },
      {
        "name": "num_images",
        "type": "integer",
        "label": "Images",
        "min": 1,
        "max": 4,
        "default": 1,
        "options": [
          1
        ]
      }
    ],
    "prices": [
      {
        "unit": "image",
        "conditions": {
          "quality": "low"
        },
        "priceMicros": 28500,
        "originalMicros": 30000,
        "credits": 3,
        "itemFeeUnits": {
          "image_urls": 0.5
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "medium"
        },
        "priceMicros": 47500,
        "originalMicros": 50000,
        "credits": 5,
        "itemFeeUnits": {
          "image_urls": 0.3
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "high"
        },
        "priceMicros": 57000,
        "originalMicros": 60000,
        "credits": 6,
        "itemFeeUnits": {
          "image_urls": 0.25
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "xhigh"
        },
        "priceMicros": 104500,
        "originalMicros": 110000,
        "credits": 11,
        "itemFeeUnits": {
          "image_urls": 0.13636363636363635
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "max"
        },
        "priceMicros": 237500,
        "originalMicros": 250000,
        "credits": 24,
        "itemFeeUnits": {
          "image_urls": 0.06
        }
      },
      {
        "unit": "image",
        "conditions": {
          "mode": "image",
          "quality": "low"
        },
        "priceMicros": 42750,
        "originalMicros": 45000,
        "credits": 5,
        "itemFeeUnits": {
          "image_urls": 0.3333333333333333
        }
      },
      {
        "unit": "image",
        "conditions": {
          "mode": "image",
          "quality": "medium"
        },
        "priceMicros": 61750,
        "originalMicros": 65000,
        "credits": 7,
        "itemFeeUnits": {
          "image_urls": 0.23076923076923078
        }
      },
      {
        "unit": "image",
        "conditions": {
          "mode": "image",
          "quality": "high"
        },
        "priceMicros": 71250,
        "originalMicros": 75000,
        "credits": 8,
        "itemFeeUnits": {
          "image_urls": 0.2
        }
      },
      {
        "unit": "image",
        "conditions": {
          "mode": "image",
          "quality": "xhigh"
        },
        "priceMicros": 118750,
        "originalMicros": 125000,
        "credits": 12,
        "itemFeeUnits": {
          "image_urls": 0.12
        }
      },
      {
        "unit": "image",
        "conditions": {
          "mode": "image",
          "quality": "max"
        },
        "priceMicros": 251750,
        "originalMicros": 265000,
        "credits": 26,
        "itemFeeUnits": {
          "image_urls": 0.05660377358490566
        }
      }
    ],
    "billing": {
      "version": 1,
      "priceScope": "gateway",
      "creditsPerUsd": 100,
      "modelParams": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt",
          "required": true
        },
        {
          "name": "image_urls",
          "type": "images",
          "label": "Reference images",
          "description": "Optional — switches to image editing",
          "maxItems": 10
        },
        {
          "name": "mask_url",
          "type": "image",
          "label": "Mask",
          "description": "White areas are edited, black kept; needs an input image"
        },
        {
          "name": "background",
          "type": "enum",
          "label": "Background",
          "options": [
            "auto",
            "transparent",
            "opaque"
          ]
        },
        {
          "name": "aspect_ratio",
          "type": "enum",
          "label": "Aspect ratio",
          "options": [
            "1:1",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "3:2",
            "2:3"
          ],
          "default": "1:1"
        },
        {
          "name": "quality",
          "type": "enum",
          "label": "Quality",
          "options": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ],
          "default": "medium"
        },
        {
          "name": "num_images",
          "type": "integer",
          "label": "Images",
          "min": 1,
          "max": 4,
          "default": 1
        }
      ],
      "videoFirstOnly": false,
      "videoRoutes": [],
      "itemFees": {
        "image_urls": {
          "usd": 0.015,
          "free": 1
        }
      }
    }
  },
  {
    "provider": "kie",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_urls",
        "type": "images",
        "label": "Reference images",
        "description": "Optional — switches to image editing",
        "maxItems": 10
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "1:1",
          "4:3",
          "3:4",
          "16:9",
          "9:16",
          "3:2",
          "2:3"
        ],
        "default": "1:1"
      },
      {
        "name": "quality",
        "type": "enum",
        "label": "Quality",
        "options": [
          "low",
          "medium",
          "high",
          "xhigh",
          "max"
        ],
        "default": "medium"
      },
      {
        "name": "num_images",
        "type": "integer",
        "label": "Images",
        "min": 1,
        "max": 4,
        "default": 1,
        "options": [
          1
        ]
      }
    ],
    "prices": [
      {
        "unit": "image",
        "conditions": {
          "quality": "low"
        },
        "priceMicros": 21110,
        "originalMicros": 22221,
        "credits": 3,
        "itemFeeUnits": {
          "image_urls": 1.012555690562981
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "medium"
        },
        "priceMicros": 37167,
        "originalMicros": 39123,
        "credits": 4,
        "itemFeeUnits": {
          "image_urls": 0.5751092707614447
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "high"
        },
        "priceMicros": 45041,
        "originalMicros": 47412,
        "credits": 5,
        "itemFeeUnits": {
          "image_urls": 0.4745634016704632
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "xhigh"
        },
        "priceMicros": 80079,
        "originalMicros": 84294,
        "credits": 9,
        "itemFeeUnits": {
          "image_urls": 0.266922912662823
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "max"
        },
        "priceMicros": 180166,
        "originalMicros": 189648,
        "credits": 19,
        "itemFeeUnits": {
          "image_urls": 0.1186408504176158
        }
      }
    ],
    "billing": {
      "version": 1,
      "priceScope": "gateway",
      "creditsPerUsd": 100,
      "modelParams": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt",
          "required": true
        },
        {
          "name": "image_urls",
          "type": "images",
          "label": "Reference images",
          "description": "Optional — switches to image editing",
          "maxItems": 10
        },
        {
          "name": "mask_url",
          "type": "image",
          "label": "Mask",
          "description": "White areas are edited, black kept; needs an input image"
        },
        {
          "name": "background",
          "type": "enum",
          "label": "Background",
          "options": [
            "auto",
            "transparent",
            "opaque"
          ]
        },
        {
          "name": "aspect_ratio",
          "type": "enum",
          "label": "Aspect ratio",
          "options": [
            "1:1",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "3:2",
            "2:3"
          ],
          "default": "1:1"
        },
        {
          "name": "quality",
          "type": "enum",
          "label": "Quality",
          "options": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ],
          "default": "medium"
        },
        {
          "name": "num_images",
          "type": "integer",
          "label": "Images",
          "min": 1,
          "max": 4,
          "default": 1
        }
      ],
      "videoFirstOnly": false,
      "videoRoutes": [],
      "itemFees": {
        "image_urls": {
          "usd": 0.0225
        }
      }
    }
  },
  {
    "provider": "vercel",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_urls",
        "type": "images",
        "label": "Reference images",
        "description": "Optional — switches to image editing",
        "maxItems": 10
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "1:1",
          "4:3",
          "3:4",
          "16:9",
          "9:16",
          "3:2",
          "2:3"
        ],
        "default": "1:1"
      },
      {
        "name": "quality",
        "type": "enum",
        "label": "Quality",
        "options": [
          "low",
          "medium",
          "high",
          "xhigh",
          "max"
        ],
        "default": "medium"
      },
      {
        "name": "num_images",
        "type": "integer",
        "label": "Images",
        "min": 1,
        "max": 4,
        "default": 1
      }
    ],
    "prices": [
      {
        "unit": "image",
        "conditions": {
          "quality": "low"
        },
        "priceMicros": 23456,
        "originalMicros": 24690,
        "credits": 3,
        "itemFeeUnits": {
          "image_urls": 1.012555690562981
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "medium"
        },
        "priceMicros": 41297,
        "originalMicros": 43470,
        "credits": 5,
        "itemFeeUnits": {
          "image_urls": 0.5751092707614447
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "high"
        },
        "priceMicros": 50046,
        "originalMicros": 52680,
        "credits": 6,
        "itemFeeUnits": {
          "image_urls": 0.4745634016704632
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "xhigh"
        },
        "priceMicros": 88977,
        "originalMicros": 93660,
        "credits": 9,
        "itemFeeUnits": {
          "image_urls": 0.266922912662823
        }
      },
      {
        "unit": "image",
        "conditions": {
          "quality": "max"
        },
        "priceMicros": 200184,
        "originalMicros": 210720,
        "credits": 21,
        "itemFeeUnits": {
          "image_urls": 0.1186408504176158
        }
      }
    ],
    "billing": {
      "version": 1,
      "priceScope": "gateway",
      "creditsPerUsd": 100,
      "modelParams": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt",
          "required": true
        },
        {
          "name": "image_urls",
          "type": "images",
          "label": "Reference images",
          "description": "Optional — switches to image editing",
          "maxItems": 10
        },
        {
          "name": "mask_url",
          "type": "image",
          "label": "Mask",
          "description": "White areas are edited, black kept; needs an input image"
        },
        {
          "name": "background",
          "type": "enum",
          "label": "Background",
          "options": [
            "auto",
            "transparent",
            "opaque"
          ]
        },
        {
          "name": "aspect_ratio",
          "type": "enum",
          "label": "Aspect ratio",
          "options": [
            "1:1",
            "4:3",
            "3:4",
            "16:9",
            "9:16",
            "3:2",
            "2:3"
          ],
          "default": "1:1"
        },
        {
          "name": "quality",
          "type": "enum",
          "label": "Quality",
          "options": [
            "low",
            "medium",
            "high",
            "xhigh",
            "max"
          ],
          "default": "medium"
        },
        {
          "name": "num_images",
          "type": "integer",
          "label": "Images",
          "min": 1,
          "max": 4,
          "default": 1
        }
      ],
      "videoFirstOnly": false,
      "videoRoutes": [],
      "itemFees": {
        "image_urls": {
          "usd": 0.025
        }
      }
    }
  }
]
```

## Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| id | string | Yes | Generation ID. Use it to query or cancel this task. |
| object | string | Yes | generation |
| model | string | Yes | gpt-image-2.6-sunburst |
| type | string | Yes | image |
| provider | string | Yes | Provider |
| status | string | Yes | queued → processing → succeeded / failed. Stop polling at either terminal state. |
| input | object | Yes | Model parameters, see the input fields below. |
| outputs | string[] | Yes | Result URLs. Empty while processing; read after succeeded and save the files promptly. |
| error | string \| null | Yes | Failure reason, or null when no failure is reported. |
| credits | number | Yes | Credits charged for this request. |
| price_usd | number | Yes | Request price in USD. |
| created_at | string | Yes | Creation time in ISO 8601 format. |
| completed_at | string \| null | Yes | Completion time in ISO 8601 format; null before completion. |

### Task submitted

```json
{
  "id": "gen_example",
  "object": "generation",
  "model": "gpt-image-2.6-sunburst",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}
```

### Task completed

```json
{
  "id": "gen_example",
  "object": "generation",
  "model": "gpt-image-2.6-sunburst",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}
```

## Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

```bash
curl "https://01router.com/api/v1/generations/GENERATION_ID" -H "Authorization: Bearer $API_KEY"
```

## Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

```bash
curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" -H "Authorization: Bearer $API_KEY"
```

## Quote

Choose API quotes or frontend quotes: the API returns costs for currently available providers; frontend quotes read prices and billing fields from models and recalculate locally when inputs change.

### API quotes

```bash
curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "gpt-image-2.6-sunburst",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  }
}
JSON
```

### Frontend quotes

Read prices: request GET /api/v1/models, optionally filtering by type. In the standard catalog, select a model by slug from data, then a channel from providers, and read that channel’s prices, params and billing. For GET /api/v1/models?project=PROJECT_ID, read these fields directly from the selected model in data. Reads are public and require no API key; project catalogs enforce their configured domain restrictions for cross-origin access.

Project prices: billing.priceScope=project means unit prices already include the resale ratio; do not apply it again. billing.creditsPerUsd=null, so these prices cannot determine gateway credits. POST /quote returns gateway prices and credits even with project supplied; it excludes project resale markup.

```text
catalog ← GET /api/v1/models (add project for a project catalog)
source ← selected model’s provider; for a project, select the model directly
input ← validate, apply defaults and derive mode using params and billing
rule ← match prices conditions; for tokens, select context tiers
quantity ← derive from unit and input; use billing.metering for audio holds
total micros ← ordinary: round(unit price × quantity); tokens: ceil(input cost + output cost)
dollars ← total micros / 1,000,000
credits ← if creditsPerUsd is non-null: max(1, ceil(dollars × creditsPerUsd - 1e-9))
Display estimate; recalculate locally on input changes without calling /quote
```

Fields: https://01router.com/docs/models
Calculation rules: https://01router.com/docs/quote

## Prompt API

Public read-only endpoints: no API key or credits required. Browse published examples for active models using combined model, source and scene filters.

```bash
curl "https://01router.com/api/v1/prompts?model=gpt-image-2.6-sunburst&locale=en&page=1"
curl "https://01router.com/api/v1/prompts/PROMPT_ID?locale=en"
```

Use modelSlug and prompt to construct the request body below for POST /generations. Generation still requires an API key and incurs model charges. Query GET /models/gpt-image-2.6-sunburst for any additional required inputs.

## Callbacks

Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

See https://01router.com/docs/callback for signature verification.

## OpenAI-compatible images

For OpenAI SDK integrations, use this endpoint with top-level prompt. It waits for the result and returns data[].url. For asynchronous tasks and the full model parameter set, use /generations.

```json
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A cinematic shot of a red fox running through snow"
}
```

## Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

```json
{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}
```

HTTP 400: invalid request; 401: unauthorized; 402: insufficient credits; 404: not found; 409: not cancelable; 429: rate/concurrency/quota limit; 5xx: upstream/server error.

Full API reference: https://01router.com/docs/errors