# CLAILA API

> One API key and one MCP server for AI images (FLUX.2, Nano Banana 2), video (Kling 2.6, Wan 2.2), music (MiniMax, ElevenLabs, Stable Audio), voice and chat models (GPT, Claude, Gemini, Grok, Mistral). Billed in CLAILA credits; 1 credit is about $0.03 when topped up.

## Connect

- MCP (Streamable HTTP, OAuth 2.1 or Bearer API key): https://api.claila.com/mcp
- REST base URL (OpenAI compatible for chat/completions and images/generations): https://api.claila.com/v1
- API keys and billing: https://app.claila.com/api
- OpenAPI: https://api.claila.com/v1/openapi.json
- Agent skill: https://api.claila.com/v1/skill.md

## Endpoints

- POST /v1/images/generations: OpenAI style image generation (model, prompt, n, size or aspect_ratio or preset)
- POST /v1/generations: any model; images return finished, video and audio return status running (pass wait up to 60)
- GET /v1/generations/{id}: status and files
- POST /v1/chat/completions: OpenAI compatible chat, streaming supported
- POST /v1/files: upload an input image, returns a file id
- GET /v1/models, GET /v1/credits, GET /v1/key

## Social presets

instagram_post, instagram_square, story_reel, youtube_thumbnail, pinterest, linkedin

## Generation models

- flux-2-pro: FLUX.2 [pro], image, 3 credits per image up to 1 megapixel; 2 MP costs double
- flux-pro-ultra: FLUX1.1 [pro] Ultra, image, 5 credits per image (up to 4 MP)
- flux-schnell: FLUX.1 [schnell], image, 1 credits per image
- nano-banana-2: Nano Banana 2, image, 6 credits per image at 1K; 2K = 9, 4K = 13 credits
- flux-2-pro-edit: FLUX.2 [pro] Edit, image, 5 credits per image
- flux-kontext: FLUX.1 Kontext [pro], image, 4 credits per image
- remove-background: Remove background, image, 2 credits per image
- upscale: SeedVR upscale, image, 3 credits per image (2x or 4x)
- kling-2.6-pro: Kling 2.6 Pro, video, 54 credits per 5 s video with sound; 10 s = 108; without sound 27 / 54
- wan-2.2: Wan 2.2 image-to-video, video, 8 credits per 5 s video, 720p
- minimax-music-2.6: MiniMax Music 2.6, audio, 12 credits per song with vocals
- elevenlabs-music: ElevenLabs Music, audio, 48 credits per 60 s track
- stable-audio-3: Stable Audio 3, audio, 3 credits per clip up to 30 s
- tts: Text to speech, audio, 3 credits per each 1000 characters

## Errors

JSON {"error": {"type", "code", "message"}}. 401 bad key, 402 credits_required (no paid plan and no prepaid credits) / insufficient_credits (with billing_url), 429 rate limit (Retry-After), 5xx provider errors are never billed.