Image edit API

Edit one or more source images from a text instruction for product, ad, and social creative workflows.

Price$0.398per request

MethodPOST

Route/v1/content/images/edit

StatusPlanned

MIME typeapplication/json

Rate limit10/minute

CacheNo cache

contentimageimage-to-imageeditfal

API URLhttps://x402.hexl.dev/v1/content/images/edit

Integration docs

Example request

{
  "prompt": "Replace the background with a bright kitchen counter",
  "imageUrls": [
    "https://example.com/source.png"
  ]
}

Example response

{
  "requestId": "content-edit-1700000000000-abc",
  "assets": [
    {
      "url": "https://fal.media/files/example-edit.png"
    }
  ],
  "provider": "fal",
  "modelClass": "standard-image-edit",
  "retailPrice": "$0.199/request"
}

Input schema

{
  "type": "object",
  "required": [
    "prompt",
    "imageUrls"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "examples": [
        "Replace the background with a bright kitchen counter"
      ]
    },
    "imageUrls": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ],
      "default": "1:1"
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "requestId",
    "assets",
    "provider",
    "modelClass",
    "retailPrice"
  ],
  "properties": {
    "requestId": {
      "type": "string"
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "width": {
            "type": "number"
          },
          "height": {
            "type": "number"
          },
          "contentType": {
            "type": "string"
          }
        }
      }
    },
    "provider": {
      "type": "string"
    },
    "modelClass": {
      "type": "string"
    },
    "retailPrice": {
      "type": "string"
    }
  }
}