Skip to content
onelayer.
All tools

Tool detail

BlockRun.AI

Edits an existing image from a text prompt using a selectable AI image model.

Categories: Image editing, Image generation

Use when

  • edit an image using a text prompt
  • apply an AI edit to an existing image with a chosen model

Not for

  • not text-to-image generation from scratch - this edits an existing image
  • source-image parameter is undocumented - schema lists only prompt/model/n/size

Inputs

POST JSON body: prompt (string, required); model (string, optional, e.g. openai/gpt-image-1); n (integer, optional); size (string, optional, e.g. 1024x1024)

Admitted input schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Image model ID (e.g., openai/gpt-image-1, openai/gpt-image-2)"
    },
    "n": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Number of images to generate"
    },
    "prompt": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Text description of the image to generate"
    },
    "size": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Image dimensions (e.g., 1024x1024)"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://blockrun.ai/api/v1/images/image2image

Payment

Protocol
x402
Listed price
0.021 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://blockrun.ai/api/v1/images/image2image
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z