{"uid":"cap_aDc5xWdBWNftEDAM14MQK","slug":"clervo-ai-responses-api-f7fea95e","name":"Clervo AI Responses API","description":"Clervo lets software use AI models and agent tools with pay-per-use x402 payments, without managing separate provider accounts or API keys.","url":"https://api.clervo.dev/v1/responses","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"id":"resp_example","text":{"format":{"type":"text"}},"error":null,"model":"clervo/allam-2-7b","store":false,"tools":[],"top_p":1,"usage":{"input_tokens":1,"total_tokens":2,"output_tokens":1,"input_tokens_details":{"cached_tokens":0},"output_tokens_details":{"reasoning_tokens":0}},"object":"response","output":[{"id":"msg_example","role":"assistant","type":"message","status":"completed","content":[{"text":"Idempotency keeps retries from becoming a second logical operation or charge.","type":"output_text","annotations":[]}]}],"status":"completed","metadata":{},"reasoning":{"effort":null,"summary":null},"created_at":0,"truncation":"disabled","temperature":1,"tool_choice":"auto","completed_at":0,"instructions":null,"max_output_tokens":64,"incomplete_details":null,"parallel_tool_calls":true,"previous_response_id":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BVIlxysR-_ze7BqNgZGow","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs AI model inference and agent tool calls on-demand via x402 micropayments, without requiring separate provider accounts or API keys","exampleAgentPrompt":"Using Clervo, send the message 'Explain what idempotency means in distributed systems' to the clervo/allam-2-7b model and give me the response — pay per call, no API key setup needed.","exampleUseCases":[{"title":"Autonomous agent LLM calls","prompt":"My software agent needs to query an AI model to decide its next action — use Clervo with the clervo/allam-2-7b model to ask 'What is the best next step given this customer complaint: the product arrived damaged?' and return the answer, paying per call automatically."},{"title":"Serverless AI feature without provider signup","prompt":"I'm building a small tool and need to generate a short product description for 'noise-cancelling wireless headphones, 30hr battery' — call the Clervo AI API with that prompt using the allam-2-7b model and keep the output under 128 tokens."},{"title":"Agentic tool-use with micropayment billing","prompt":"Run an agent task on Clervo: give it the instruction 'Search for today's top AI news headlines and summarize them' with tool_choice set to auto, and bill me per call in USDC — I don't want to manage a separate OpenAI or Anthropic account for this."}],"resultDescription":"A JSON response object containing the generated text output, the model used, token usage breakdown (input, output, cached, reasoning tokens), response status, output message array with role and content, tool call results if tools were invoked, and metadata like response ID and timestamps.","failureModes":["Payment failure: insufficient USDC balance or x402 payment not accepted, resulting in 402 status","Model not found: invalid model name returns an error in the error field","Rate limiting or quota exceeded on the underlying model provider","Malformed request body causing validation errors","Max output tokens reached, returning incomplete_details in the response","Tool invocation failure if tool definitions are misconfigured"],"whenToPreferThis":"Choose Clervo when your software or agent needs to call AI models without managing separate API keys or provider accounts, and when per-call micropayment billing via x402/USDC is preferred over monthly subscriptions. Ideal for autonomous agents that need to pay for LLM calls programmatically, serverless functions making occasional AI calls, or multi-tenant applications where billing per inference is more suitable than flat-rate plans.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:32:07.747Z","isFirstParty":false}