# StableStudio GPT-Image-2 Edit

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

Edits or modifies an existing image using OpenAI's GPT-Image-2 model, returning a job ID for async retrieval, billed per generation with no subscription.

## Facts

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

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-2-edit-c48272a8 -d '<json body>'
```

Example prompt: Edit this product photo to replace the white background with a cozy coffee shop interior — use GPT-Image-2 on StableStudio and make sure the subject stays exactly the same.

## When to prefer this

Choose this endpoint when you need to edit or modify an existing image using GPT-Image-2 specifically, on a pay-per-call basis with no subscription commitment. Prefer it over subscription-based services when usage is infrequent or cost-per-call economics are acceptable. Use it when the async job model (polling via jobId) is acceptable for your workflow.

## Known failure modes

- Payment of $10 USDC not received — request rejected
- Invalid or missing source image — 400 error
- Unsupported image format or size
- Prompt violates content policy — generation refused
- Job creation succeeds but image generation fails asynchronously — check status via jobId
- Network timeout before job is created

## How this service works

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

## Output

A JSON object containing the generation type ('gpt-image-2-edit'), a unique jobId string, a status field (initially 'pending'), and a success boolean. The agent must poll or retrieve the result using the jobId once processing 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": [
    "opaque",
    "auto"
   ],
   "type": "string",
   "default": "auto",
   "description": "Background fill behavior for generated image 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"
  },
  "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-2-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-2-edit-c48272a8/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)