# OATDA — One API to Direct Agents

> Agent-native multi-modal AI infrastructure (text, vision, image, video, audio).
> 10+ providers (OpenAI, Anthropic, Google, DeepSeek, Moonshot, ...) behind a single API key.
> EU-based. Credit-based pay-as-you-go billing. Min top-up €1.
> MCP-native: full Model Context Protocol server built in.

## Quick Start

- Base URL (OpenAI-compat): https://oatda.com/api/v1
- Base URL (Anthropic-compat): https://oatda.com/api/v1/anthropic
- MCP Server URL: https://oatda.com/api/v1/mcp
- Auth header: `Authorization: Bearer $OATDA_API_KEY`
- Get an API key: https://oatda.com/dashboard/api-keys
- Top up credits (min €1): https://oatda.com/dashboard/credits
- Machine-readable pricing: GET https://oatda.com/api/v1/pricing

## Endpoints (OpenAI-compatible)

- POST /api/v1/chat/completions — chat (stream + non-stream)
- POST /api/v1/llm — native chat (direct cost in response)
- GET  /api/v1/models — list models
- GET  /api/v1/pricing — machine-readable pricing catalog (no auth required)
- POST /api/v1/llm/generate-image — image generation (DALL-E, Imagen, ...)
- POST /api/v1/llm/generate-video — video generation (MiniMax, Veo, Seedance, ...)
- POST /api/v1/llm/speech — text-to-speech
- POST /api/v1/llm/transcriptions — audio transcription
- POST /api/v1/llm/translations — audio translation
- POST /api/v1/llm — vision/image analysis (contents[] multimodal). Legacy /llm/image alias deprecated.
- POST /api/v1/compare — compare multiple models in one call

## Endpoints (Anthropic-compatible)

- POST /api/v1/anthropic/v1/messages — Messages API (Cline, Claude Code, Aider)
- GET  /api/v1/anthropic/v1/models

## MCP Server (Streamable HTTP)

- URL: https://oatda.com/api/v1/mcp
- Transport: Streamable HTTP, JSON-RPC 2.0 (MCP spec)
- Auth: `Authorization: Bearer $OATDA_API_KEY`
- 9 tools: `chat_completion`, `vision_analysis`, `generate_image`, `generate_video`, `get_video_status`, `generate_speech`, `transcribe_audio`, `translate_audio`, `list_models`
- No install required: API key + credits is enough.

## Pricing

- Per-model, pay-as-you-go. No subscription, no free tier.
- Min top-up: €1. Methods: credit card, PayPal.
- JSON catalog: GET /api/v1/pricing (no auth required, rate-limited)
- Per-model pricing in model list: GET /api/v1/llm/models (requires Authorization: Bearer $OATDA_API_KEY)
- Human-readable: https://oatda.com/pricing

## Agent Capabilities

- `agents.md`: https://oatda.com/agents.md
- `.well-known/agent.json`: https://oatda.com/.well-known/agent.json

## Docs

- Full markdown (all 5 locales, EN/DE/ES/FR/IT): https://oatda.com/llms-full.txt
- Per-section markdown: GET /api/v1/docs/markdown?sectionId=<sectionId>
  Sections: gettingStarted, authentication, coreEndpoints, openaiCompatible,
  anthropicCompatible, extraBody, mcp, skills, useCases, examples, errorHandling
- Human docs: https://oatda.com/docs

## Code Examples

```bash
# OpenAI-compat chat
curl https://oatda.com/api/v1/chat/completions \
  -H "Authorization: Bearer $OATDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-4o-mini", "messages": [{"role": "user", "content": "hi"}]}'
```

```bash
# Anthropic-compat messages
curl https://oatda.com/api/v1/anthropic/v1/messages \
  -H "x-api-key: $OATDA_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-20250514", "max_tokens": 1024, "messages": [{"role": "user", "content": "hi"}]}'
```

```bash
# MCP server (JSON-RPC)
curl https://oatda.com/api/v1/mcp \
  -H "Authorization: Bearer $OATDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
```

## Provider notes

- Provider prefix in `model` field (e.g. `openai/gpt-4o-mini`, `anthropic/claude-sonnet-4-20250514`).
- Streaming via SSE on all chat endpoints (`stream: true`).
- Native endpoint `/api/v1/llm` returns direct cost info in response (simpler for scripts).

## Agent skills (drop-in integration)

- **Claude Code plugin**: https://github.com/devcsde/oatda-skills
  Install: `/plugin marketplace add devcsde/oatda-skills` → browse → Install.
  9 skills: text, vision, image, video, video-status, speech, transcribe, translate, list-models.
- **OpenClaw skills**: https://github.com/devcsde/oatda-openclaw-skills
  Install: `clawhub install oatda-text-completion` (and 8 more; see README).
- **MCP (Cursor, Cline, Claude Code, etc.)**: https://oatda.com/api/v1/mcp — no install needed.

## Optional

[Links]: https://oatda.com/llms-full.txt | https://oatda.com/agents.md | https://oatda.com/.well-known/agent.json | https://oatda.com/docs | https://oatda.com/pricing | https://oatda.com/models