# Syllaby API

> REST API for AI video generation: **faceless** social-media videos (create a
> draft, add a script, configure voice/genre/captions, render asynchronously,
> poll for the mp4). JSON over HTTPS, Bearer-token auth, credit-metered.

- Base URL (production): https://api.syllaby.io/v2
- Auth: `Authorization: Bearer <token>` on every request (token-only, stateless —
  no cookies/CSRF). Tokens come from Syllaby account settings.
- Rate limit: 30 requests/minute per API token by default; `429` responses carry
  `Retry-After` and `X-RateLimit-Reset`.
- Credits: generative endpoints (faceless render/retry/export/script generation)
  charge account credits; charging responses carry
  `meta.credits` (cost + remaining).
- Envelope: success bodies are `{ message, status, data }`; errors use standard
  HTTP codes (400/401/404/422/429) with `{ message }` (+ `errors` map on 422).
- Polling rule: track renders with the faceless `id`, NOT `video_id`.

## Docs

- [Getting started & guides](https://api-docs.syllaby.io/md/getting-started.md):
  typical flow, get-your-rendered-video walkthrough, auth, credits, errors,
  rate limits
- [Account endpoints](https://api-docs.syllaby.io/md/account.md): The authenticated user — profile, per-feature credit costs, and the credit ledger.
- [Faceless Videos endpoints](https://api-docs.syllaby.io/md/faceless-videos.md): Create, configure, render, and retrieve faceless videos, their assets, and reusable presets.
- [OpenAPI 3.1 spec (JSON)](https://api-docs.syllaby.io/openapi/v2.json)
- [Full reference as one file](https://api-docs.syllaby.io/llms-full.txt)

## Optional

- [Interactive reference (Scalar)](https://api-docs.syllaby.io/)
- [Get an API key](https://ai.syllaby.io/settings/api-tokens)