x402factory.ai

{
  "input": {
    "bodyFields": {
      "action": {
        "description": "Optional action. Use 'message' (or omit action) for a direct GPT call, 'create' to create a custom agent with a preprompt, or 'list' to list your custom agents without calling OpenAI.",
        "enum": [
          "message",
          "create",
          "list"
        ],
        "required": false,
        "type": "string"
      },
      "custom_id": {
        "description": "Optional custom agent ID returned from action=create. When set, the preprompt + model from that agent are used. Can also be provided via URL: /solana/llm/gpt/{custom_id}.",
        "required": false,
        "type": "string"
      },
      "max_input_tokens": {
        "description": "Optional hard ceiling on input tokens used for pricing. For normal calls this caps the user message tokens. For custom agents this caps the user message tokens on top of the fixed preprompt. If the actual message is longer than this value, the server returns an error instead of under-pricing.",
        "required": false,
        "type": "number"
      },
      "max_output_tokens": {
        "description": "Maximum number of output tokens. Default 2000. Higher limits increase the prepaid price because x402 payments are upfront.",
        "required": false,
        "type": "number"
      },
      "message": {
        "description": "User message for the LLM. Required for normal GPT calls. For action=create this becomes the preprompt that is stored for the custom agent.",
        "required": false,
        "type": "string"
      },
      "model": {
        "description": "Logical model name. One of: gpt-5.1, gpt-5-mini (default), gpt-5-nano, gpt-5-pro. Pricing is per model using per-million token rates.",
        "enum": [
          "gpt-5.1",
          "gpt-5-mini",
          "gpt-5-nano",
          "gpt-5-pro"
        ],
        "required": false,
        "type": "string"
      }
    },
    "bodyType": "json",
    "method": "POST",
    "type": "http"
  },
  "output": {
    "action": {
      "description": "Action performed: 'call' for direct GPT calls, 'call_custom' for custom agents, 'create' for new custom agents, 'list' for listing your custom agents.",
      "type": "string"
    },
    "agents": {
      "description": "For action=list: up to 100 recent custom agents for the paying wallet. Each entry includes custom_id, model, max_output_tokens, base_price_usdc, preprompt_preview (first 250 chars), created_at and updated_at.",
      "type": "array"
    },
    "base_price_usdc": {
      "description": "For action=create, the stored base price for the agent (max_input_tokens_for_agent + preprompt + max_output_tokens) using the selected model.",
      "type": "number"
    },
    "custom_id": {
      "description": "Custom agent ID used for this call, if any. For action=create this is the newly created agent ID.",
      "type": "string"
    },
    "estimated_input_tokens": {
      "description": "Estimated number of input tokens used for pricing. For custom agents this includes both preprompt and user message.",
      "type": "number"
    },
    "max_output_tokens": {
      "description": "Maximum output tokens used for this call (after applying any defaults and limits).",
      "type": "number"
    },
    "model": {
      "description": "Model used for this call",
      "type": "string"
    },
    "ok": {
      "description": "True on success",
      "type": "boolean"
    },
    "preprompt": {
      "description": "For action=create, the stored preprompt text. For custom calls, the preprompt used for the agent.",
      "type": "string"
    },
    "price_usdc": {
      "description": "Price charged for this call in USDC (6 decimals, rounded up). Minimum is 0.001 USDC. Default direct calls cost 0.01 USDC for up to 1000 input tokens with gpt-5-mini and max_output_tokens=2000.",
      "type": "number"
    },
    "reply": {
      "description": "For GPT calls, the assistant reply text from OpenAI.",
      "type": "string"
    }
  }
}