Locus public pay-per-use API

Locus public pay-per-use API

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://perplexity.x402.paywithlocus.com/perplexity/chat

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "max_tokens": 1,
    "messages": [
      {
        "content": "Hello from x402",
        "role": "user"
      }
    ],
    "model": "sonar"
  },
  "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": {
          "additionalProperties": true,
          "properties": {
            "max_tokens": {
              "description": "Maximum output tokens (up to 128000). Required to bound metered x402 authorization.",
              "type": "number"
            },
            "messages": {
              "description": "Conversation messages. Each: { role: \"system\"|\"user\"|\"assistant\", content: \"text\" } or multimodal with image_url content blocks.",
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            "model": {
              "description": "Metered x402 Sonar model ID: 'sonar', 'sonar-pro', or 'sonar-reasoning-pro'. Deep Research is excluded because its autonomous usage cannot be safely preauthorized.",
              "type": "string"
            },
            "reasoning_effort": {
              "description": "Reasoning effort level (sonar-reasoning-pro only): 'minimal', 'low', 'medium', 'high'",
              "type": "string"
            },
            "response_format": {
              "additionalProperties": true,
              "description": "Structured output. { type: \"json_schema\", json_schema: { name: \"...\", schema: {...} } }",
              "type": "object"
            },
            "return_images": {
              "description": "Include image results in the response",
              "type": "boolean"
            },
            "return_related_questions": {
              "description": "Include related follow-up questions in the response",
              "type": "boolean"
            },
            "search_domain_filter": {
              "description": "Restrict search to specific domains",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "search_language_filter": {
              "description": "Filter search results by language (ISO 639-1 codes)",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "search_recency_filter": {
              "description": "Time filter for search results: 'hour', 'day', 'week', 'month', 'year'",
              "type": "string"
            },
            "temperature": {
              "description": "Sampling temperature (0.0\u20132.0)",
              "type": "number"
            },
            "top_p": {
              "description": "Nucleus sampling threshold (0.0\u20131.0)",
              "type": "number"
            },
            "web_search_options": {
              "additionalProperties": true,
              "description": "Web search configuration: { search_context_size: 'low'|'medium'|'high', search_type: 'fast', user_location: { country: '...', city: '...' } }. Metered x402 excludes pro/auto because they can trigger uncapped multi-step usage and require streaming.",
              "type": "object"
            }
          },
          "required": [
            "model",
            "messages",
            "max_tokens"
          ],
          "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": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON