S
spritesynthDOCS

Edit Image

AI-powered image editing with natural language instructions.

Edit Image

Edit existing pixel art images using AI. Describe what you want changed and the model will modify the image accordingly.

Endpoint

POST /api/image-ops/edit

Parameters

NameTypeRequiredDescription
asset_idstringYesID of the asset to edit
instructionstringYesNatural language description of the edit to apply
edit_typestringNoType of edit: modify, enhance, restyle. Default: modify

Example

curl -X POST https://api.spritesynth.com/api/image-ops/edit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "asset_abc123",
    "instruction": "add a glowing aura around the character",
    "edit_type": "modify"
  }'

Response

{
  "id": "edit_901",
  "status": "completed",
  "asset": {
    "url": "https://cdn.spritesynth.com/assets/edit_901.png",
    "width": 128,
    "height": 128
  },
  "credits_cost": 1,
  "duration_ms": 1800
}

Tips

  • Be specific in your instructions — "make the sword longer" works better than "change it".
  • Use enhance to improve quality without changing content.
  • Use restyle to change the art style while preserving composition.

Need help?

Join our Discord community for support and tips.
Was this page helpful?

On this page