Skip to main content
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 work on every plan, and every call spends credits from your Percify balance.

​
What it costs to start

Three facts, because they are usually assumed to be one: So an agent can connect to Percify in two clicks. Every run spends the account’s own credits: plan credits first, then API funds added on dash.percify.io. API funds work for API keys, MCP and the dash playground, not in the app. Credit packs start at 200 credits for $5, add to a plan’s credits and never expire, while plan credits do not roll over.

​
Base URL

Every request needs the header Authorization: Bearer pk_live_…. See Authenticate Percify API requests. Successful responses wrap the result in a data object:

​
Endpoints

Two longer pipelines have their own endpoints on the same host: AI agents can use the same account through the Percify MCP server at https://mcp.percify.io/mcp.

​
Who can use the API?

Every account can create API keys, on every plan. API usage draws on the same credits as the app: 450 a month on Starter, 1,233 on Creator, 3,000 on Scale and 8,000 on Ultra. Plan prices and billing are explained in Plans and payments. Without a plan, or when plan credits run out, add API funds on dash.percify.io: pay as you go from $10 up to $1,000, at $0.02 a credit. Runs use plan credits first, then API funds, and a failed run is refunded to the balance that paid for it.

​
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

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.

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.
Last modified on October 19, 2026