Api Endpoint

BlockRun.AI

Edit or vary an existing image with a text prompt.

Open interactive test console

Offering

Provider: BlockRun.AI
Method: POST
Offering type: Api Endpoint
Transport type: http
Category: Creative
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://arc.blockrun.ai/api/v1/images/image2image
MIME type: application/json
First seen: 2026-10-16T01:50:03.601Z
Last seen: 2026-11-04T17:19:38.699Z
Tags: X402, AI, blockchain, ai-&-ml

Website Documentation OpenAPI

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 64000 atomic units
Atomic price: 64000 · Network: eip155:5042 · Asset: 0x3600000000000000000000000000000000000000 · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:5042",
    "asset": "0x3600000000000000000000000000000000000000",
    "amount": "64000",
    "payTo": "0x634D274e67DafaF76C54153aa113906a606e1E0B"
  }
]

Observed health

Status: Healthy
Latest latency: 1909 ms
Average latency: 451 ms
HTTP status: 204
Last checked: 2026-11-02T00:35:31.027Z
Reachability: 100% over 11 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "body": {
    "type": "object",
    "required": [
      "prompt",
      "image"
    ],
    "properties": {
      "n": {
        "type": "integer",
        "default": 1,
        "maximum": 4,
        "minimum": 1
      },
      "mask": {
        "type": "string",
        "pattern": "^data:image/",
        "description": "Optional mask as base64 data URI; transparent pixels mark the editable region. OpenAI models only — rejected for Google models."
      },
      "size": {
        "enum": [
          "1024x1024",
          "1792x1024",
          "1024x1792"
        ],
        "type": "string",
        "default": "1024x1024"
      },
      "image": {
        "oneOf": [
          {
            "type": "string",
            "pattern": "^data:image/"
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^data:image/"
            },
            "maxItems": 4,
            "minItems": 1
          }
        ],
        "description": "Source image(s) as base64 data URI(s). Pass a single string, or an array (OpenAI-compatible image[]) to fuse multiple sources — e.g. a reference image + a brand logo. Max 4 for OpenAI, 3 for Google. Multi-image cannot be combined with mask."
      },
      "model": {
        "enum": [
          "openai/gpt-image-1",
          "openai/gpt-image-2",
          "google/nano-banana",
          "google/nano-banana-2",
          "google/nano-banana-pro"
        ],
        "type": "string",
        "default": "openai/gpt-image-2"
      },
      "prompt": {
        "type": "string",
        "description": "Edit instructions for the image."
      }
    }
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
}

Output schema

{
  "type": "object",
  "properties": {
    "example": {
      "type": "object",
      "properties": {
        "data": {
          "type": "array"
        },
        "created": {
          "type": "number"
        }
      }
    }
  }
}