Fast image generation API

Generate a production-ready image from a text prompt using the lowest-latency image model tier.

Price$0.198per request

MethodPOST

Route/v1/content/images/generate

StatusPlanned

MIME typeapplication/json

Rate limit10/minute

CacheNo cache

contentimagetext-to-imagegenerationfal

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

Integration docs

Example request

{
  "prompt": "Studio photo of a matte black smart wallet on marble",
  "aspectRatio": "1:1"
}

Example response

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

Input schema

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "examples": [
        "Studio photo of a matte black smart wallet on marble"
      ]
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ],
      "default": "1:1"
    },
    "imageSize": {
      "type": "string",
      "enum": [
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ],
      "default": "square_hd"
    }
  }
}

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"
    }
  }
}