Percify API: base URL, keys and plans

The Percify REST API runs image, video and voice models at api.percify.io/v3/playground/v1 with a pk_live key. Keys come with Scale and Ultra.

The Percify API lets your code run the same image, video and voice models as the Percify app, including talking avatar lip-sync and voice cloning. You send a model id and its inputs to https://api.percify.io/v3/playground/v1/run with an API key, then read the result from the generation. API keys come with the Scale and Ultra plans, and every call spends credits from your Percify balance.

Base URL

https://api.percify.io/v3/playground/v1

Every request needs the header Authorization: Bearer pk_live_…. See Authenticate Percify API requests.

Successful responses wrap the result in a data object:

{ "success": true, "data": { "id": "…", "status": "processing" } }

Endpoints

Method	Path	What it does	Auth
POST	/v1/run	Start a generation	API key
GET	/v1/generations/{id}	Read a generation’s status and output	API key
POST	/v1/estimate	Price a run without spending credits	API key
GET	/v1/models	List every model and its inputs	None
GET	/v1/models/{id}	One model’s input schema	None
GET	/v1/openapi.json	OpenAPI 3.1 document for run and poll	None
GET	/v1/llms.txt	Plain-text catalog for agents	None

Two longer pipelines have their own endpoints on the same host:

• https://api.percify.io/v3/replicate/v1: analyze a short video and render a replica.
• https://api.percify.io/v3/mascot/api: make a finished short video from a topic.

AI agents can use the same account through the Percify MCP server at https://mcp.percify.io/mcp.

Who can use the API?

You can create API keys on the Scale and Ultra plans. On other plans, creating a key fails with 403 and the message API access is available on the Scale plan. Upgrade to create API keys.

API usage draws on the same monthly credits as the app: 3,000 credits a month on Scale and 8,000 on Ultra. Plan prices and billing are explained in Plans and payments. When you need more credits, use Top up credits on the developer page.

How do I get an API key?

1. Open the developer page

   Sign in at app.percify.io, open the account menu at the bottom of the sidebar and choose API Access. This opens app.percify.io/home/developer.

2. Create the key

   Click New key. Optionally add a name, pick an expiry (Never expires, Expires in 30 days, Expires in 90 days or Expires in 1 year) and set a Monthly credit cap. Then click Create key.

3. Copy it once

   The full pk_live_ key is shown only once. Store it in a secret manager or an environment variable on your server.

How billing works for API calls

• A run’s credits are taken when it starts. The response includes creditsSpent.
• If the run fails or times out, the credits go back to your balance automatically.
• Prices depend on the model and its inputs. Lip-sync is billed per second of audio, and some models change price with quality or resolution. Call POST /v1/estimate to get the exact number first.
• A key’s Monthly credit cap stops that key from spending more than the cap in a calendar month.

Limits at a glance

Limit	Value
Requests per API key	60 per minute
Generation starts per account	60 per minute
Per-key spend	Your Monthly credit cap, if set

Details and error bodies are in Errors and rate limits.

Call the API from your server. Browsers on other websites cannot call api.percify.io directly, and a key in front-end code can be copied by anyone.

Related

Authenticate requests

Send your pk_live key, rotate it and cap its spend.

Code examples

Node.js, Python and cURL, start to finished file.

Make a talking avatar video

Image, voice and lip-sync in three calls.

MCP server

Use Percify from Claude, ChatGPT, Cursor or Codex.