# Beatra

> Agent-native multimodal creation through a Universal Skill, OAuth MCP, and REST/OpenAPI.

The Beatra REST API is the custom-application integration surface. It uses API keys under `/v1`, public OpenAPI contracts, and durable async tasks for long-running media work.

## REST API

- Base URL: https://api.beatra.ai/v1
- Authentication: API key; obtain and manage keys in the Customer Console.
- Execution: synchronous where supported, otherwise durable tasks with polling and optional signed callbacks.

## Start here

- [API landing](https://api.beatra.ai): Public REST integration overview
- [Quickstart](https://docs.beatra.ai/en/docs/quickstart): First Beatra integration
- [Authentication](https://docs.beatra.ai/en/docs/authentication): API-key and request conventions
- [API reference](https://docs.beatra.ai/en/docs/api-reference): Browsable operation-level reference

## Capability families

- [Capability map](https://docs.beatra.ai/en/docs/capabilities): Chat, images, video, music, speech, voices, public social data, models, uploads, tasks, and artifacts
- [Live models and prices](https://docs.beatra.ai/en/docs/models): Current selectable model roster

## Shared mechanisms

- [Async tasks](https://docs.beatra.ai/en/docs/mechanisms/async-tasks): Task lifecycle, polling, cancellation, and response envelopes
- [Uploads](https://docs.beatra.ai/en/docs/mechanisms/uploads): Upload source media and reference it as an artifact
- [Callbacks](https://docs.beatra.ai/en/docs/mechanisms/callbacks): Signed terminal-state notifications, retries, and verification
- [Billing and usage](https://docs.beatra.ai/en/docs/mechanisms/billing): Credits, prepaid execution, 402 behavior, and automatic refunds
- [Errors and retries](https://docs.beatra.ai/en/docs/mechanisms/errors): Error envelopes, retryability, and error codes
- [Rate limits](https://docs.beatra.ai/en/docs/mechanisms/rate-limits): Limits and X-RateLimit response headers

## Machine contracts

- [Canonical OpenAPI YAML](https://docs.beatra.ai/openapi.yaml): Reviewed public contract
- [Canonical OpenAPI JSON](https://docs.beatra.ai/openapi.json): Reviewed public contract as JSON
- [Live runtime OpenAPI](https://api.beatra.ai/openapi.json): Currently deployed runtime schema

## Agent alternative

- [Install Universal Skill](https://beatra.ai/install.md): Preferred installation path for autonomous agents
- [OAuth MCP](https://mcp.beatra.ai): Connect agents through MCP rather than managing API keys

## Support

- Email: support@beatra.ai