Use when you need an llm chat completion for summaries, extraction or classifica

Use when you need an llm chat completion for summaries, extraction or classification from a cheap open model. Do not use for frontier models, tool calling or streaming. Returns JSON with a chat completion from IBM Granite 4.0 Micro on Workers AI, with token usage for 0.002 USDC per thousand tokens, up to 0.03 USDC per call (clients without upto pay the cap). Asynchronous: the paid call returns a jobId and a free pollUrl; typical job time 8000 ms (p95). Category: Inference.

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/llm-chat

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "maxTokens": 80,
    "messages": [
      {
        "content": "In one sentence, what is the x402 payment protocol?",
        "role": "user"
      }
    ]
  },
  "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": {
            "maxTokens": {
              "description": "Maximum tokens to generate (1-4096, 512 when omitted); billed as requested",
              "maximum": 4096,
              "minimum": 1,
              "type": "integer"
            },
            "messages": {
              "description": "Conversation so far, oldest first, e.g. [{\"role\": \"user\", \"content\": \"Summarize: ...\"}]",
              "items": {
                "properties": {
                  "content": {
                    "description": "Message text",
                    "maxLength": 32000,
                    "minLength": 1,
                    "type": "string"
                  },
                  "role": {
                    "description": "Who wrote the message",
                    "enum": [
                      "system",
                      "user",
                      "assistant"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "role",
                  "content"
                ],
                "type": "object"
              },
              "maxItems": 50,
              "minItems": 1,
              "type": "array"
            },
            "temperature": {
              "description": "Sampling temperature (0-2), e.g. 0.2 for near-deterministic output",
              "maximum": 2,
              "minimum": 0,
              "type": "number"
            }
          },
          "required": [
            "messages"
          ],
          "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