{"info":{"contact":{"email":"hello@clervo.dev","name":"Clervo","url":"https://clervo.dev"},"description":"Low-price, agent-native x402 gateway. One wallet, one OpenAI-compatible API, many AI models. Pay per call in USDC.","title":"Clervo x402 Gateway","version":"2026-07-25.3"},"openapi":"3.1.0","paths":{"/healthz":{"get":{"operationId":"health","responses":{"200":{"description":"Process health"}},"security":[]}},"/readyz":{"get":{"operationId":"readiness","responses":{"200":{"description":"Control-plane readiness"}},"security":[]}},"/v1/catalog":{"get":{"operationId":"catalog","responses":{"200":{"description":"Public service catalog"}},"security":[]}},"/v1/chat/completions":{"post":{"operationId":"createChatCompletion","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"max_completion_tokens":{"maximum":1024,"minimum":1,"type":"integer"},"max_output_tokens":{"maximum":1024,"minimum":1,"type":"integer"},"max_tokens":{"description":"Compatibility alias for max_completion_tokens.","maximum":1024,"minimum":1,"type":"integer"},"messages":{"items":{"additionalProperties":false,"properties":{"content":{"maxLength":24000,"minLength":1,"type":"string"},"role":{"enum":["system","user","assistant"],"type":"string"}},"required":["role","content"],"type":"object"},"minItems":1,"type":"array"},"model":{"description":"A model ID returned by GET /v1/models.","type":"string"},"response_format":{"additionalProperties":true,"type":"object"},"stream":{"default":false,"enum":[false],"type":"boolean"}},"required":["model","messages"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Successful service result"},"402":{"description":"Payment required. Present only after the service is purchasable."},"503":{"description":"Service is not active."}},"security":[],"summary":"OpenAI-compatible multi-model chat completions for autonomous agents.","tags":["Services"],"x-callable":true,"x-lifecycle":"free_beta","x-purchasable":false}},"/v1/chat/completions/x402":{"post":{"description":"Scanner-compatible paid alias for /v1/chat/completions. It always returns a model-specific x402 challenge before execution when PAYMENT-SIGNATURE is absent.","operationId":"createPaidChatCompletion","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"max_completion_tokens":{"maximum":1024,"minimum":1,"type":"integer"},"max_output_tokens":{"maximum":1024,"minimum":1,"type":"integer"},"max_tokens":{"description":"Compatibility alias for max_completion_tokens.","maximum":1024,"minimum":1,"type":"integer"},"messages":{"items":{"additionalProperties":false,"properties":{"content":{"maxLength":24000,"minLength":1,"type":"string"},"role":{"enum":["system","user","assistant"],"type":"string"}},"required":["role","content"],"type":"object"},"minItems":1,"type":"array"},"model":{"default":"clervo/code","description":"A paid model ID returned by GET /v1/models.","enum":["clervo/code","quickai/gpt-5.4-mini","quickai/gpt-5.4","quickai/gpt-5.5","quickai/gpt-5.6-luna","quickai/gpt-5.6-terra","quickai/gpt-5.6-sol","tongkhokr/claude-haiku-4.5","tongkhokr/claude-sonnet-5","tongkhokr/claude-opus-5","tongkhokr/claude-sonnet-4.6","tongkhokr/claude-opus-4.7","tongkhokr/claude-opus-4.8"],"type":"string"},"response_format":{"additionalProperties":true,"type":"object"},"stream":{"default":false,"enum":[false],"type":"boolean"}},"required":["model","messages"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Successful paid service result"},"400":{"description":"Invalid or unavailable model/request"},"402":{"description":"Model-specific x402 v2 payment challenge"},"503":{"description":"Paid runtime unavailable"}},"summary":"Always-paid x402 chat completions compatibility endpoint","tags":["Services"],"x-callable":true,"x-lifecycle":"paid_beta","x-purchasable":true}},"/v1/models":{"get":{"operationId":"models","responses":{"200":{"description":"OpenAI-compatible public model catalog"}},"security":[]}},"/v1/models/{modelId}":{"get":{"operationId":"modelDetail","parameters":[{"description":"URL-encoded model ID, for example quickai%2Fgpt-5.4-mini.","in":"path","name":"modelId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Model detail"},"404":{"description":"Model not found"}},"security":[],"summary":"Get lifecycle, funding, pricing, capabilities, limits, and provenance for one model","tags":["Models"]}},"/v1/operations/{operationId}":{"get":{"operationId":"operationStatus","parameters":[{"in":"path","name":"operationId","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Operation status"},"404":{"description":"Operation not found"}},"security":[],"summary":"Get customer-safe operation status and receipt metadata","tags":["Operations"]}},"/v1/search":{"post":{"operationId":"webSearch","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"max_output_tokens":{"maximum":0,"minimum":1,"type":"integer"},"messages":{"items":{"additionalProperties":false,"properties":{"content":{"maxLength":500,"minLength":1,"type":"string"},"role":{"enum":["system","user","assistant"],"type":"string"}},"required":["role","content"],"type":"object"},"minItems":1,"type":"array"},"response_format":{"additionalProperties":true,"type":"object"}},"required":["messages"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Successful service result"},"402":{"description":"Payment required. Present only after the service is purchasable."},"503":{"description":"Service is not active."}},"security":[],"summary":"Real-time web search. Returns structured results with titles, URLs, and snippets.","tags":["Services"],"x-callable":true,"x-lifecycle":"free_beta","x-purchasable":false}}},"servers":[{"url":"https://api.clervo.dev"}]}