# Video Studio API

> Quoted, idempotent AI media jobs paid with your Fina credits.

Quoted, idempotent AI media jobs paid with your Fina credits.

| Field | Value |
| --- | --- |
| Base URL | `https://fina.do/api/video-studio/v1` |
| Authentication | Bearer personal API key (`fina_vs_…`) |
| OpenAPI 3.1 | [/api/video-studio/v1/openapi.json](https://fina.do/api/video-studio/v1/openapi.json) |
| Built for | Scripts and tools of a Fina Video Studio user |

Create a personal API key in your Fina profile. Every spending mutation needs an `Idempotency-Key` header; credits are reserved at the quoted maximum and never charged above it.

### Endpoints

Base URL: `https://fina.do/api/video-studio/v1`

| Method | Path | Summary | Auth |
| --- | --- | --- | --- |
| GET | `/me` | Identity, plan and spendable credits | Personal key |
| GET | `/businesses` | Your businesses (not archived), by name | Personal key |
| GET | `/businesses/{id}` | Everything needed to make videos and images of one of your businesses | Personal key |
| GET | `/locals` | Your locals («Mis locales»: visual profiles of your physical spaces) | Personal key |
| GET | `/locals/{id}` | One of your locals: description, usable photos and the linked business | Personal key |
| GET | `/catalog` | Server-driven catalog of operations and models | Personal key |
| POST | `/quotes` | Create an immutable, expiring quote | Personal key |
| POST | `/uploads` | Register an input and get a signed upload URL | Personal key |
| POST | `/uploads/{id}/complete` | Verify the uploaded object (existence, size, sha256 when feasible) | Personal key |
| GET | `/jobs` | List jobs (cursor pagination) | Personal key |
| POST | `/jobs` | Create a job (reserves the quoted maximum before any provider call) | Personal key |
| GET | `/jobs/{id}` | Job detail (reconciles with the provider when pending) | Personal key |
| POST | `/jobs/{id}/cancel` | Cancel a job (free before submit; honest otherwise) | Personal key |
| GET | `/assets/{id}/download` | Short-lived signed download URL for your own asset | Personal key |

Source: https://fina.do/developers#api-video-studio