# Clipia Developer Documentation

> Use Clipia with AI agents through remote MCP media-generation tools, or automate image and video workflows with the REST API and SDKs.

Primary agent guide: https://clipia.ai/en/docs/mcp

## Pages

- [Account & balance](https://clipia.ai/en/docs/api-reference/account): GET /v1/account — balance and usage.
- [Errors](https://clipia.ai/en/docs/api-reference/errors): Clipia API's unified error format, the table of HTTP statuses and errorCodes, and which ones are safe to retry.
- [Estimate cost](https://clipia.ai/en/docs/api-reference/estimate): POST /v1/models/{model}/estimate — know the price before you run anything.
- [Idempotency](https://clipia.ai/en/docs/api-reference/idempotency): The Idempotency-Key header lets you safely retry generation requests without double-charging credits.
- [Overview](https://clipia.ai/en/docs/api-reference): Interactive Clipia API reference: parameters, schemas, examples and a Try-it playground right in the docs.
- [Managing keys](https://clipia.ai/en/docs/api-reference/keys): Create and revoke API keys in the developer console, the Bearer/Key/X-Api-Key auth schemes, and access scopes.
- [Model catalog](https://clipia.ai/en/docs/api-reference/models): GET /v1/models — current Clipia AI models for image, video, and audio generation.
- [Seedance 2.5 API: slugs, parameters, and pricing](https://clipia.ai/en/docs/api-reference/models/seedance-2-5): Seedance 2.5 API reference: T2V and I2V slugs, request parameters, credit pricing per duration and resolution, and how to submit a generation over REST or MCP.
- [Generation queue](https://clipia.ai/en/docs/api-reference/overview): Clipia REST API async queue — submit, status, result, and webhooks for image and video generation.
- [Rate limits](https://clipia.ai/en/docs/api-reference/rate-limits): Per-key RPM and concurrency limits, the RateLimit-* response headers, and how to handle a 429 response.
- [Generation result](https://clipia.ai/en/docs/api-reference/result): GET /v1/requests/{request_id} — fetch the result.
- [Request status](https://clipia.ai/en/docs/api-reference/status): GET /v1/requests/{request_id}/status — check a generation's status.
- [Submit a generation](https://clipia.ai/en/docs/api-reference/submit): POST /v1/models/{model} — enqueue a generation and send the request interactively.
- [Webhooks](https://clipia.ai/en/docs/api-reference/webhooks): Receive a POST notification when a generation finishes, verified with HMAC-SHA256 and retried automatically.
- [Changelog](https://clipia.ai/en/docs/changelog): Change history for the Clipia public API v1, the MCP server and the SDKs — launch, contract updates and new capabilities.
- [Authentication](https://clipia.ai/en/docs/getting-started/authentication): How to authorize Clipia API requests — API keys, three header schemes, live vs test keys, scopes, and secure storage.
- [Quickstart](https://clipia.ai/en/docs/getting-started/quickstart): Run your first Clipia API image generation in four steps — from creating a key to fetching the finished result.
- [Sandbox](https://clipia.ai/en/docs/getting-started/sandbox): The Clipia API sandbox — clipia_test_* keys run the full submit → status → result cycle with no credits charged and return a sample result.
- [Best practices](https://clipia.ai/en/docs/guides/best-practices): Practices for a reliable Clipia API integration — idempotent retries, webhooks over polling, error and 429 handling with backoff, cost estimation, and storing request_id.
- [Migrating from fal.ai](https://clipia.ai/en/docs/guides/fal-migration): Move a fal.ai integration to the Clipia API — mapping for endpoints, headers, statuses, and webhooks, plus the key differences.
- [Introduction](https://clipia.ai/en/docs): Clipia API, MCP and SDK documentation — image and video generation for developers and AI agents.
- [Account & limits](https://clipia.ai/en/docs/llm-gateway/account): GET /v1/key and GET /v1/generation in Clipia AI Gateway — check key limits and spend, exact request cost, rate-limit headers and the 429 response.
- [Chat Completions](https://clipia.ai/en/docs/llm-gateway/chat-completions): POST /v1/chat/completions — the OpenAI-compatible chat endpoint of Clipia AI Gateway. Non-streaming and streaming responses, parameters, tool calling and structured outputs.
- [Clipia AI Gateway](https://clipia.ai/en/docs/llm-gateway): A single OpenAI-compatible API to Claude, GPT, Gemini, DeepSeek and Grok, billed in rubles. Get a key and make your first request in minutes.
- [LangChain](https://clipia.ai/en/docs/llm-gateway/langchain): Connect Clipia AI Gateway to LangChain via ChatOpenAI with the Clipia base_url — chat, tools and tool agents on Claude, GPT and Gemini.
- [Models & pricing](https://clipia.ai/en/docs/llm-gateway/models): The Clipia AI Gateway model catalog (GET /v1/models) and prices in rubles per 1M tokens — Claude, GPT, Gemini, DeepSeek, Grok.
- [Use Clipia with AI agents](https://clipia.ai/en/docs/mcp): Give AI agents video, image, speech, music and presentation tools through Clipia MCP, or automate image and video generation with the REST API.
- [MCP tools](https://clipia.ai/en/docs/mcp/tools): Reference for 10 core and 5 capability-dependent Clipia MCP tools for AI agents, plus 7 app-only helpers for interactive result cards.
- [Python SDK](https://clipia.ai/en/docs/sdk/python): The official Clipia Python SDK (PyPI clipia) — install, initialize the client and run the full generation cycle: submit, wait and result.
- [TypeScript SDK](https://clipia.ai/en/docs/sdk/typescript): The official Clipia TypeScript SDK (npm clipia-ai) — install, initialize the client, submit a job and wait for the generation result.