Back to Browse
Clervo AI Responses API
x402
Clervo AI Responses API is a paid API for AI agents from api.clervo.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).
Runs AI model inference and agent tool calls on-demand via x402 micropayments, without requiring separate provider accounts or API keys
Price / call$0.001
Success—
StatusUnknown
How this service works
Clervo lets software use AI models and agent tools with pay-per-use x402 payments, without managing separate provider accounts or API keys.
Output
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.
Example use cases
Autonomous agent LLM calls
“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.”
Serverless AI feature without provider signup
“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.”
Agentic tool-use with micropayment billing
“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.”
Technical details
Endpoint
POSThttps://api.clervo.dev/v1/responsesWhen to prefer
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.
Side effects
- 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
Output
Schema · Response
{
"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
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"