Instant image editing
Edit one or more images with a plain-language instruction in about a second: swap backgrounds, relight, combine subjects.
POST /api/v1/nodes/image-edit-instant
Quick setup for humans and agents
- 1. Fund an x402 wallet with a little USDC on Base. AgentCash (above), Coinbase Wallet or any x402 client works. One dollar covers hundreds of calls.
- 2. Call the endpoint. The first response is HTTP 402 with the exact price.
- 3. Your wallet signs and retries. TollNode runs the node and collects the quoted price only if the result is usable.
see the 402 yourself
curl -i -X POST https://tollnode.com/api/v1/nodes/image-edit-instant \
-H 'content-type: application/json' \
-d '{"images":["https://tollnode.com/opengraph-image"],"prompt":"put this product on a marble kitchen counter"}'Input
| Field | Type | Notes |
|---|---|---|
| seed | integer | |
| images* | array | Images to edit (https URLs) |
| prompt* | string | What to create or change |
| aspect_ratio | enum | Aspect ratio, default match_input_image (match_input_image, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3) |
Example response
{
"images": [
"https://tollnode.com/api/v1/files/00000000-0000-0000-0000-000000000000/0"
]
}FAQ
- What does the Instant image editing node return?
- Edit one or more images with a plain-language instruction in about a second: swap backgrounds, relight, combine subjects.
- How much does one call cost?
- $0.015 in USDC on Base, per successful call. No sign-up, subscription or API key.
- What happens if the call fails?
- You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
- How does an AI agent pay?
- With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.