Edit Image

client.images.edit(params)

POST/v1/images/edits

Edit one or more uploaded images through SandBase's synchronous OpenAI Images-compatible multipart endpoint.

Multipart uploads

Send model, prompt, and image as multipart/form-data. Repeating the image field preserves multiple source files.

Synchronous only

stream=true, mode=stream, and mode=async are rejected.

Errors

400

Invalid multipart body, unsupported model, streaming mode, or provider request.

401

Missing or invalid API key.

402

Organization or API Key spending limit reached.

403

API key scope does not authorize this endpoint.

404

The routed image-edit model is unavailable.

429

Rate limit exceeded.

500

Request persistence or response processing failed.

502

The provider returned an invalid native response.

503

No provider route succeeded.

curl https://api.sandbase.ai/v1/images/edits \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -F model=gpt-image-2 \
  -F 'prompt=Turn the daytime sky into a starry night' \
  -F image=@landscape.png

Response200 OK

{
  "created": 1787529600,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ],
  "usage": {
    "input_tokens": 1024,
    "output_tokens": 4096,
    "total_tokens": 5120,
    "input_tokens_details": {
      "text_tokens": 12,
      "image_tokens": 1012
    }
  }
}