LLM Chat

Chat with a language model via an OpenAI-compatible /v1/chat/completions interface. Supports 50+ models. Free models are $0 (bypass the paywall entirely) — paid models are charged at cost.

Pricing

• Free models (auto, eco, premium) — $0.00. No on-chain challenge. Bypasses the paywall.
• Paid models (e.g. gpt-5.2, claude-opus-5, deepseek-v4-pro) — priced per request; the amount varies by model and token count.
• Base price listed as $0.002 for discovery purposes. Actual charge for paid models is dynamic.

Prices shown are for a typical request (≈1K prompt + 1K output tokens); long prompts or large max_tokens cost more. The exact amount is always quoted in the 402 challenge before you sign. Free models (auto, eco, premium) are $0 — no on-chain payment. Catalog refreshes automatically; query GET /tools/llm_chat/models for the machine-readable list.

Request

POST /tools/llm_chat
Content-Type: application/json

{
  "model": "auto",
  "messages": [
    { "role": "user", "content": "Say hello in 3 words" }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}

Parameters

Response

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "free/gpt-oss-120b",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hello there! 👋" },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 66,
    "completion_tokens": 38,
    "total_tokens": 104
  }
}

Model Catalog

Fetch the full list of supported models and their rates dynamically:

GET /tools/llm_chat/models

Returns a JSON array of all models with id, name, upstreamCost, and whether the model is free (free: true).

⚡ Try with your wallet — live payment

Try it

curl -s 'https://x402.freeq.one/tools/llm_chat' \
  -H 'Content-Type: application/json' \
  -d '{"model":"auto","messages":[{"role":"user","content":"hi"}]}'

# Paid model (triggers x402 challenge):
curl -s 'https://x402.freeq.one/tools/llm_chat' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-5.2","messages":[{"role":"user","content":"hi"}]}'