Edit image

POST

https://api.spicyapi.com/api/v1/tools/edit_image

Prompt-driven edit of one to three images the account generated (list_images), for outfit, pose and scene changes. Synchronous; returns a durable CDN URL. Billed per edit. Guarded: without approval_token it returns {error: "approval_required", summary, approval_token}; show the summary (it carries the cost), get the user's yes, call again with the token. GUARDED: without approval_token it returns {error: 'approval_required', summary, approval_token}; show the summary to the user, get a yes, call again with the token (or the account turns approvals off in the dashboard).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200

The tool's JSON result (same payload the MCP tool returns).

This response does not have a body.

🟠400

🟠401

🟠402

🟠403

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.spicyapi.com/api/v1/tools/edit_image' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "string",
    "prompt": "string",
    "image_urls": [
        "http://example.com"
    ],
    "negative_prompt": "string",
    "size": "string",
    "seed": -9007199254740991,
    "approval_token": "string"
}'

Modified at 2026-09-21 21:07:45

Generate image

Generate video