Bluma API

name: Bluma API
description: Asynchronous short-form video generation REST API. Submit a template id and a prompt to POST
  /v1/videos, receive a job id, and collect the finished render either by polling GET /v1/videos/{id}
  or by subscribing to the video.completed webhook, then fetch a one-hour signed URL from GET /v1/videos/{id}/download.
  Also covers template discovery, credit balance and history, API key lifecycle (create, list, rotate
  with a 30-day grace, revoke), webhook registration and delivery logs, and usage metrics. Authenticated
  with prefixed bearer API keys (bluma_test_ / bluma_live_) carrying eight product scopes.
humanURL: https://docs.getbluma.com/api-reference/overview
baseURL: https://api.getbluma.com/api/v1
tags:
- Video Generation
- AI
- Content Creation
- Media
properties:
- type: Documentation
  url: https://docs.getbluma.com/
- type: APIReference
  url: https://docs.getbluma.com/api-reference/overview
- type: GettingStarted
  url: https://docs.getbluma.com/quickstart
- type: Authentication
  url: authentication/bluma-authentication.yml
- type: OAuthScopes
  url: scopes/bluma-scopes.yml
- type: ErrorCatalog
  url: errors/bluma-problem-types.yml
- type: RateLimits
  url: rate-limits/bluma-rate-limits.yml
- type: Conventions
  url: conventions/bluma-conventions.yml
- type: Webhooks
  url: asyncapi/bluma-webhooks.yml
- type: DataModel
  url: data-model/bluma-data-model.yml
- type: Sandbox
  url: sandbox/bluma-sandbox.yml
- type: Lifecycle
  url: lifecycle/bluma-lifecycle.yml
- type: Conformance
  url: conformance/bluma-conformance.yml
- type: AgentSkill
  url: skills/_index.yml
x-openapi-advertised:
  url: https://api.getbluma.com/api/v1/openapi.json
  http_status: 401
  checked: '2026-08-12'
  note: Bluma's API Reference Overview advertises a complete OpenAPI at this URL and tells readers to
    import it into Postman, Insomnia or Swagger UI. It returns 401 "No authorization token provided" to
    an anonymous request, so the spec could not be retrieved and none has been saved. Publishing it unauthenticated
    is the single highest-value fix available to this provider.