Use when you need image generation or text to image from a prompt for illustrati

Use when you need image generation or text to image from a prompt for illustrations or mockups. Do not use for image edits, specific sizes, photos of real people or more than one image per call. Returns JSON with a 1024x1024 JPEG generated from a text prompt by FLUX.1 schnell on Workers AI, as base64 for 0.03 USDC per call. Asynchronous: the paid call returns a jobId and a free pollUrl; typical job time 10000 ms (p95). Category: Media.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://x402-gateway.blackwoodstate8.workers.dev/v1/image-gen

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "prompt": "A brass lighthouse on a dark navy sea at dusk, minimalist flat illustration",
    "steps": 4
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "prompt": {
              "description": "What the image should show, in English, e.g. a lighthouse on a cliff at sunset, watercolor",
              "maxLength": 2048,
              "minLength": 3,
              "type": "string"
            },
            "steps": {
              "description": "Diffusion steps (1-8, 4 when omitted); more steps, more detail",
              "maximum": 8,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "prompt"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": false,
          "properties": {
            "expiresAt": {
              "description": "ISO 8601: depois disso o resultado deixa de existir",
              "type": "string"
            },
            "jobId": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "next": {
              "additionalProperties": false,
              "description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
              "properties": {
                "method": {
                  "enum": [
                    "GET",
                    "POST"
                  ],
                  "type": "string"
                },
                "sample": {
                  "description": "Free fixed sample of the whole family",
                  "type": "string"
                },
                "service": {
                  "description": "Service id of the suggested next paid call",
                  "type": "string"
                },
                "tool": {
                  "description": "MCP tool name of the same call",
                  "type": "string"
                },
                "url": {
                  "description": "Paid route of the next call",
                  "type": "string"
                },
                "useWhen": {
                  "description": "When the next call is the right one",
                  "type": "string"
                }
              },
              "required": [
                "service",
                "tool",
                "method",
                "url",
                "useWhen",
                "sample"
              ],
              "type": "object"
            },
            "pollUrl": {
              "format": "uri",
              "type": "string"
            },
            "status": {
              "const": "queued",
              "type": "string"
            }
          },
          "required": [
            "jobId",
            "pollUrl",
            "expiresAt",
            "status"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON