# StableStudio GPT-Image-1.5 Edit

> StableStudio GPT-Image-1.5 Edit is a paid API for AI agents from stablestudio.io, paid per call via x402, $10/call, status unknown (last checked 2026-09-13).

Generates or edits AI images using the GPT-Image-1.5 model with configurable resolution, aspect ratio, and safety settings, billed per generation via x402 micropayment.

## Facts

- Endpoint: POST https://stablestudio.io/api/generate/gpt-image-1.5/edit
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablestudio-gpt-image-1-5-edit-5672b272
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h4kfCwss9SL5LV7irsqiB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablestudio-gpt-image-1-5-edit-5672b272 -d '<json body>'
```

Example prompt: Generate a photorealistic image of a misty mountain lake at sunrise using StableStudio — make it 4MP resolution in a 16:9 landscape ratio, output as a PNG, and use seed 42 so it's reproducible.

## When to prefer this

Choose this endpoint when you need on-demand AI image generation powered by GPT-Image-1.5 without a subscription — ideal for agents that generate images infrequently or at variable volumes. Prefer it when fine control over resolution (up to 4MP), aspect ratio, seed reproducibility, and output format is needed. The x402 pay-per-call model ($10 USDC) makes it suitable for sporadic or bursty workloads without commitment.

## Known failure modes

- Missing or empty prompt — returns validation error (prompt is required, minLength 1)
- Payment failure — x402 payment of $10 USDC not fulfilled, generation not started
- Invalid resolution enum value — must be one of '0.5 MP', '1 MP', '2 MP', '4 MP'
- Invalid aspect_ratio enum — must match one of the nine supported ratios
- Safety tolerance out of range — must be integer 1–5
- Output quality out of range — must be integer 0–100
- Prompt exceeds maxLength of 10,000 characters
- Job creation succeeds but asynchronous generation fails — jobId returned but image never produced

## How this service works

Pay-per-generation AI image and video creation. No subscriptions ever.

## Output

A JSON object with a job ID, generation status ('pending'), type identifier ('gpt-image-1.5-edit'), and a success flag. The agent must poll or await the job to retrieve the final image URL once generation is complete.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "size": {
   "enum": [
    "1024x1024",
    "1536x1024",
    "1024x1536",
    "auto"
   ],
   "type": "string",
   "description": "Image dimensions (square, landscape, portrait, or auto)"
  },
  "images": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri",
    "description": "Image URL"
   },
   "minItems": 1,
   "description": "Array of image URLs to edit"
  },
  "prompt": {
   "type": "string",
   "minLength": 1,
   "description": "A detailed description of the image you want to generate"
  },
  "quality": {
   "enum": [
    "low",
    "medium",
    "high"
   ],
   "type": "string",
   "default": "high",
   "description": "Output quality level (affects cost and detail)"
  },
  "background": {
   "enum": [
    "transparent",
    "opaque",
    "auto"
   ],
   "type": "string",
   "default": "auto",
   "description": "Background transparency for PNG output"
  },
  "moderation": {
   "enum": [
    "low",
    "auto"
   ],
   "type": "string",
   "default": "low",
   "description": "Content moderation strictness"
  },
  "output_format": {
   "enum": [
    "png",
    "jpeg",
    "webp"
   ],
   "type": "string",
   "default": "png",
   "description": "Output image format"
  },
  "input_fidelity": {
   "enum": [
    "high",
    "low"
   ],
   "type": "string",
   "default": "high",
   "description": "Fidelity to input images (high preserves more details)"
  },
  "output_compression": {
   "type": "number",
   "default": 0,
   "maximum": 100,
   "minimum": 0,
   "description": "Compression level (0-100, higher = smaller file)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "gpt-image-1.5-edit",
  "jobId": "cmpbmzaee000j04jrzx4f43tw",
  "status": "pending",
  "pollUrl": "https://stablestudio.dev/api/jobs/cmpbmzaee000j04jrzx4f43tw",
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablestudio-gpt-image-1-5-edit-5672b272/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablestudio.io](https://www.zero.xyz/host/stablestudio.io/llms.txt)
