# Animica Route — AI Agent Action Selector

> Animica Route — AI Agent Action Selector is a paid API for AI agents from animica.dev, paid per call via x402, $0.001794/call, status unknown (last checked 2026-09-15).

Given a goal and a list of possible actions, uses AI to select the best action, its arguments, confidence, and reasoning for an agent to execute next.

## Facts

- Endpoint: POST https://animica.dev/x402/route
- Price: $0.001794/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/animica-route-ai-agent-action-selector-c6e71ee4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fjoQo0AZD3R_18pocfMHH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability animica-route-ai-agent-action-selector-c6e71ee4 -d '<json body>'
```

Example prompt: I'm trying to achieve the goal 'book a flight for the user' and I have these 5 possible actions: search_flights, check_availability, reserve_seat, process_payment, send_confirmation — each with their descriptions and parameters. Which action should I call next, what arguments should I pass, and how confident are you?

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call AI decision layer that selects among 2–20 discrete actions for an agentic workflow — especially when you don't want to manage your own LLM API key, need a fast action-routing step with confidence scoring and escalation signals, and want to pay only per inference via x402/USDC. Prefer alternatives if you need to generate free-form text, stream responses, or require a specific model provider.

## Known failure modes

- Missing required 'goal' field returns a 400-style error
- Fewer than 2 or more than 20 actions in the actions array may be rejected
- Malformed action objects without a name or description may cause low-confidence or error responses
- Payment failure (402) if the x402 USDC payment of ~$0.005452 is not included or rejected
- Ambiguous goal/context may result in low confidence scores or escalate=true
- Model unavailability on Animica's backend could cause 5xx errors

## How this service works

Give a goal and the actions available to you; get back the single best action, its arguments, a confidence and a reason. The chosen action is constrained by schema enum to your list, so it can never name a tool you do not have. Built for the decision an agent makes before spending a frontier-model call — including the honest answer that it should escalate. Priced per call. For high-volume use, buy prepaid credits (POST /x402/credits/buy) and send X-Animica-Credits on each request — no settlement, no gas, no per-call payment round trip. Paying in ANM on the animica:1 lane is also ~25% cheaper because we sponsor no gas there.

## Output

A JSON object containing: the name of the selected action, the arguments to pass to it, a confidence score (0–1), a natural-language reason explaining the choice, a boolean escalate flag indicating whether the agent should hand off to a human, and the name of the model that made the decision.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "goal": {
   "type": "string",
   "description": "what the agent is trying to achieve"
  },
  "actions": {
   "type": "array",
   "description": "2..20 actions: {name, description, parameters?}"
  },
  "context": {
   "type": "string",
   "description": "extra state the decision depends on"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/animica-route-ai-agent-action-selector-c6e71ee4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from animica.dev](https://www.zero.xyz/host/animica.dev/llms.txt)
