# JarvisClaw AI API

> AI model routing platform. 40+ models (GPT, Claude, Gemini, DeepSeek, etc).
> Pay per call with USDC via x402 protocol. No account needed. OpenAI-compatible.

## Try it now (free, no key, no wallet)
curl -X POST https://api.jarvisclaw.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "auto/free", "messages": [{"role": "user", "content": "Hello"}]}'

Send no Authorization header at all: the free tier admits only credential-less requests (rate limited per IP), and a placeholder key is rejected with 401.
Paid models answer the same request with HTTP 402 carrying the exact price quote — sign it and retry (see Payment below, or https://api.jarvisclaw.ai/llms-full.txt for the full walkthrough).

## AI Models
- Chat Completions: POST https://api.jarvisclaw.ai/v1/chat/completions (OpenAI-compatible, streaming, function calling, vision)
- Responses API: POST https://api.jarvisclaw.ai/v1/responses (OpenAI Responses format)
- Image Generation: POST https://api.jarvisclaw.ai/v1/images/generations (DALL-E, GPT-Image, CogView, Grok Imagine)
- Image Editing: POST https://api.jarvisclaw.ai/v1/images/edits
- Video Generation: POST https://api.jarvisclaw.ai/v1/videos/generations (Sora, Seedance, Grok Video)
- Audio / TTS: POST https://api.jarvisclaw.ai/v1/audio/speech
- Audio Transcription: POST https://api.jarvisclaw.ai/v1/audio/transcriptions
- Music Generation: POST https://api.jarvisclaw.ai/v1/audio/generations
- Embeddings: POST https://api.jarvisclaw.ai/v1/embeddings
- Reranking: POST https://api.jarvisclaw.ai/v1/rerank
- Moderations: POST https://api.jarvisclaw.ai/v1/moderations
- Web Search: POST https://api.jarvisclaw.ai/v1/search
- Realtime (WebSocket): GET https://api.jarvisclaw.ai/v1/realtime
- Model List: GET https://api.jarvisclaw.ai/v1/models

## Marketplace Services
- creation (AI Creation): https://api.jarvisclaw.ai/v1/marketplace/creation/*
- voice (AI Voice Calls): https://api.jarvisclaw.ai/v1/marketplace/voice/*
- rpc (Blockchain): https://api.jarvisclaw.ai/v1/marketplace/rpc/*
- portrait (Character Enrollment): https://api.jarvisclaw.ai/v1/marketplace/portrait/*
- compute (Compute): https://api.jarvisclaw.ai/v1/marketplace/compute/*
- defi (Crypto Data): https://api.jarvisclaw.ai/v1/marketplace/defi/*
- dex (DEX Trading): https://api.jarvisclaw.ai/v1/marketplace/dex/*
- realface (Face Enrollment): https://api.jarvisclaw.ai/v1/marketplace/realface/*
- markets (Market Prices): https://api.jarvisclaw.ai/v1/marketplace/markets/*
- music (Music Generation): https://api.jarvisclaw.ai/v1/marketplace/music/*
- phone (Phone & Voice): https://api.jarvisclaw.ai/v1/marketplace/phone/*
- prediction (Prediction Markets): https://api.jarvisclaw.ai/v1/marketplace/prediction/*
- audio (Text to Speech): https://api.jarvisclaw.ai/v1/marketplace/audio/*
- video (Video Generation): https://api.jarvisclaw.ai/v1/marketplace/video/*
- exa (Web Search): https://api.jarvisclaw.ai/v1/marketplace/exa/*

## Federated API Catalogue
- 4428 individually priced API endpoints spanning web search, blockchain and market data, OCR, document and image processing, code execution, DNS and geolocation — each callable by resource id and settled per call in USDC
- Browse / search the catalogue: GET https://api.jarvisclaw.ai/api/marketplace/apis (paged; each row carries resource_id, name, category and price)
- Invoke one by id: POST https://api.jarvisclaw.ai/v1/marketplace/api/{resource_id}
- Typical price: median $0.0115 USDC per call; 1862 of 4428 endpoints (42%) cost under $0.01. Each is quoted exactly in its 402 challenge and listed with its price in the catalogue
- Largest categories: blockchain (588), general (568), search (429), finance (239), social (201), crypto-data (196), developer (184), data-tools (173), code (162), ai (123)

## User-Published APIs (UAPI Marketplace)
- Browse APIs: GET https://api.jarvisclaw.ai/api/user-api/list
- Use any published API: https://api.jarvisclaw.ai/v1/uapi/{slug}/* (independent pricing per API)

## Midjourney
- Submit tasks: POST https://api.jarvisclaw.ai/mj/submit/imagine, https://api.jarvisclaw.ai/mj/submit/change, https://api.jarvisclaw.ai/mj/submit/blend, etc.
- Check status: GET https://api.jarvisclaw.ai/mj/task/{id}/fetch
- Face swap: POST https://api.jarvisclaw.ai/mj/insight-face/swap

## Agent Registry
- Search agents: GET https://api.jarvisclaw.ai/api/agents
- Register your agent: POST https://api.jarvisclaw.ai/api/agents/register
- Heartbeat: POST https://api.jarvisclaw.ai/api/agents/heartbeat

## Authentication (payment always settles via x402)
Every paid request settles on-chain via x402 (USDC). Pick how you authenticate:
- API Key: Authorization: Bearer sk-... — billing settles through x402 via your platform-assigned HD wallet (Base + Solana).
- External wallet: sign the PAYMENT-SIGNATURE header yourself with your own private key. No account required. Both Base and Solana are supported by the Python SDK (>=3.1.1) and the Go SDK (>=v2.2.0); each detects the chain from the key's encoding.

## Payment Networks
- Base (EVM): USDC on Base mainnet (CAIP-2: eip155:8453)
- Solana: USDC on Solana mainnet (CAIP-2: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)

## Pricing (machine-readable)
- [Model pricing](https://api.jarvisclaw.ai/api/discovery/models): every model with per-token USD pricing (GET)
- [Free models](https://api.jarvisclaw.ai/api/discovery/free-models): free and cheap models for testing (GET)
- [Platform health](https://api.jarvisclaw.ai/api/discovery/health): status and capabilities (GET)

## SDKs
- Python (native): pip install jarvisclaw
- Go: go get github.com/api-jarvisclaw/go-sdk/v2
- TypeScript: npm install @jarvisclaw-ai/sdk
- MCP (any client): npx jarvisclaw-mcp
- CLI: npm install -g jarvisclaw
- Python (LangChain): pip install 'langchain-jarvisclaw>=0.1.1'
- Python (CrewAI): pip install crewai-jarvisclaw
- Python (AutoGen): pip install autogen-jarvisclaw (API key only)

## Discovery
- [x402 Discovery](https://api.jarvisclaw.ai/.well-known/x402): paid resources + prices, Base & Solana USDC (GET)
- [A2A Agent Card](https://api.jarvisclaw.ai/.well-known/agent.json): Google Agent-to-Agent (GET), then POST https://api.jarvisclaw.ai/a2a
- [AIP Discovery](https://api.jarvisclaw.ai/.well-known/agent-intent-protocol.json): intent resolve/execute + signed receipts (GET)
- [MCP Server](https://api.jarvisclaw.ai/mcp): Model Context Protocol, JSON-RPC 2.0 (POST; tools/list to enumerate)
- [Agent Manifest](https://api.jarvisclaw.ai/agent-manifest.json): structured machine discovery (GET)
- [OpenAPI Spec](https://api.jarvisclaw.ai/openapi.json) (GET)
- [Agent Registry](https://api.jarvisclaw.ai/api/agents) (GET)
- [Health](https://api.jarvisclaw.ai/api/discovery/health) (GET)

## Payment
- Protocol: x402 (USDC on Base and Solana). No account required.
- Header: PAYMENT-SIGNATURE (X-PAYMENT is accepted as an alias)
- Flow: call any paid endpoint without auth -> receive 402 with the exact quote -> sign -> retry with the header
- Alternative: Authorization: Bearer sk-... with a pre-funded API key

## Documentation
- [Docs](https://jarvisclaw.ai/docs/): guides and API reference
- [Quickstart](https://jarvisclaw.ai/docs/quickstart): first call in a minute
- [SDK Reference](https://jarvisclaw.ai/docs/sdk): Python, Go and TypeScript
- [Framework Integrations](https://jarvisclaw.ai/docs/frameworks): LangChain, CrewAI, AutoGen
- [Full walkthrough](https://api.jarvisclaw.ai/llms-full.txt): this file plus the first paid x402 call, step by step

## Agent Economy
- Intent Resolution: POST /v1/intent/resolve — declare intent + constraints, get optimal provider (FREE)
- One-shot Execute: POST /v1/intent/execute — resolve + execute in single request
- Wallet Management: GET /v1/wallet/balance — autonomous treasury for agents
- Full loop: discover → budget check → execute → settle
- 40+ AI providers with real-time cost/quality/latency scoring
- Supports x402 micropayments (zero registration) and API key auth