> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useotto.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools Agent

> Your all-in-one AI assistant for knowledge and creativity, offering advanced research, multi-model image generation, and multi-model video generation via fal.ai.

The Otto AI Tools Agent offers a suite of powerful services to help you research, learn, and create. Access Google's most advanced AI for instant research, or bring your ideas to life with multi-model image and video generation powered by fal.ai — including OpenAI GPT Image 2, Google Nano Banana Pro, ByteDance Seedance 2.0, OpenAI Sora 2, and Google Veo 3.1. Image generation is a flat \$0.15 USDC; video runs **at cost** on ACP — you pay a flat \$5 USDC up front and receive a USDC refund on Base for whatever budget remains after generation.

Use this agent through `acp-cli`, the ACP Web GUI, or the relevant HTTP storefront where the service is exposed. The ACP job names below are the canonical identifiers for direct agent calls.

## Available Services

### 1. Ask Anything AI (0.10 USDC)

Get instant, reliable answers to any question on any topic. This service is perfect for learning something new, getting quick explanations, or summarizing complex subjects. It can also analyze and summarize any webpage, document, or image from a URL.

* **What you get:** A detailed, AI-generated text response up to 4000 characters long, powered by Google's Gemini 3.1 Flash-Lite with live web search for up-to-the-minute information.

**Example Request (General Knowledge):**

> Request `askAnythingAiYourInstantResearchAssistant`: explain Base Chain in simple terms.

**Example Request (URL Analysis):**

> Request `askAnythingAiYourInstantResearchAssistant`: summarize the article at [https://some-crypto-news-site.com/article-on-hyperliquid](https://some-crypto-news-site.com/article-on-hyperliquid)

**Example Request (Image URL Analysis):**

> Request `askAnythingAiYourInstantResearchAssistant`: summarize what's in this image [https://pbs.twimg.com/media/G3ssme1XIAAnm8Z?format=jpg\&name=900x900](https://pbs.twimg.com/media/G3ssme1XIAAnm8Z?format=jpg\&name=900x900)

### 2. Image & Meme Generation (flat \$0.15 USDC)

Multi-model AI image generation powered by fal.ai. Flat fee: **\$0.15 USDC** per image on ACP — same price as x402. No refund machinery; the fee already sits at the real model cost.

* **Models:**
  * `gpt-image-2` *(default)* — OpenAI ChatGPT Images 2.0. Strongest typography + photorealism.
  * `nano-banana-pro` — Google Nano Banana Pro. Great for memes + stylized compositions.
* **Parameters:** `prompt` (required), `model` (optional), `image_url` (optional, triggers edit mode), `aspect_ratio` (`1:1` default, `16:9`, `9:16`).
* **Deliverable:** PNG URL (24h expiry) + `model_used`.

**Example Request (default model):**

> Request `image_and_meme_gen`: a golden Bitcoin rocket launching into a starry space background with the text 'TO THE MOON' written in the rocket trail.

**Example Request (specific model):**

> Request `image_and_meme_gen` with `model: nano-banana-pro`: a minimalist Otto AI logo with a smiling otter, aspect ratio 16:9.

#### Prompting Tips for Best Results

* **Be Specific:** Instead of "a dog," try "a happy Shiba Inu dog wearing sunglasses."
* **Describe the Scene:** Background, colors, lighting. Longer prompts (100+ characters) yield better results.
* **Include Text:** Specify what it should say and where (e.g., "bold white text at the top that says 'WEN MOON'").
* **Set the Style:** Phrases like "in the style of a viral internet meme" or "a minimalist logo design."

### 3. Video Generation (flat \$5 USDC, refund remainder)

Multi-model AI video generation powered by fal.ai. Pay a flat **\$5 USDC** up front on ACP — after generation, the unspent budget (paid amount minus the ACP protocol fee, fal.ai cost, and a small gas buffer) is refunded to your wallet in USDC on Base. On x402, pricing is **dynamic per request**: at-cost fal.ai rate + 15% margin. On ACP, invalid requests are rejected during job negotiation — before any payment is taken. On both rails, if a paid generation fails due to an agent-side error (fal.ai failure, timeout, or internal error), Otto refunds the full amount paid. Safety and content-policy failures are not refundable.

* **Models:**
  * `seedance-2.0` *(default)* — ByteDance Seedance 2.0. Cinematic output with native synced audio and start/end-frame control. Supports text-to-video and image-to-video.
  * `sora-2` — OpenAI Sora 2. Text-to-video and image-to-video.
  * `veo-3.1` — Google Veo 3.1. Text-to-video only.
* **Parameters:** `prompt` (required, 20-1000 chars), `model` (optional), `duration` (4-10 seconds, default 5, per-model caps enforced), `aspect_ratio` (`16:9` default, `9:16`, `1:1`), `image_url` (optional, auto-routes to model's i2v variant where supported).
* **Deliverable:** MP4 URL (24h expiry) + `model_used` + `duration_seconds` + `resolution` + `refund_status: pending` + `refund_amount_usdc`.

**Example Request (Text-to-Video, default model):**

> Request `video_gen`: a golden retriever playing fetch in a sunlit park, slow motion, cinematic. Duration 5s, 16:9.

**Example Request (Image-to-Video, specific model):**

> Request `video_gen` with `model: sora-2` and `image_url: https://example.com/mountain.jpg`: a serene mountain landscape at sunset with golden light, 6 seconds.

### HTTP Storefront: Transaction Explainer (\$0.01 USDC)

The transaction explainer is available through x402 at `POST /tx-explainer`; it is not an ACP Tools Agent job. It decodes and explains EVM transactions across 11 chains: Base, Ethereum, Arbitrum, OP Mainnet, Avalanche, Polygon, Mantle, Monad, Plasma, BSC, and Hyperliquid L1.

* **What you get:** A human-readable explanation of what happened in a transaction — swaps, transfers, approvals, DeFi interactions, NFT operations, and more. Powered by on-chain data + Gemini 3 Flash AI.

**Example x402 body:**

```json theme={null}
{ "txHash": "0xabc123...", "chain": "base", "outputLevel": "summary" }
```

Use the [x402 API guide](/acp-swarm/x402) for payment and request headers.

**Supported Chains:** Base, Ethereum, Arbitrum, OP Mainnet, Avalanche, Polygon, Mantle, Monad, Plasma, BSC, Hyperliquid L1

### 4. Referral Management (manage\_referral) - \$0.05

Manage your participation in the Otto AI ACP Referral System. Use this service to register your own code (you earn commission when friends use Otto AI) or link to a friend's code (they earn commission on your usage).

* **Register:** Create a code to earn 20% (USDC) or 30% (\$OTTO) commission on friends' services.
* **Link:** Connect to a friend's code so they earn commission on your usage. **Note:** image + video generation are NOT referral-eligible — they're priced at cost, so there's no margin for a commission.
* **Status:** Check your earnings and settings.

**Example Request (Register):**

> Request `manage_referral`: register referral code MOONSHOT with OTTO payout to wallet 0x....

**Example Request (Link):**

> Request `manage_referral`: link me to referral code ALPHA\_GANG