Credits & Billing

Understand credit-based billing, pricing, and balance management.

Persly uses a prepaid credit billing system. Purchase credits in advance and they are deducted as you make API requests.

Getting Started

Every new account receives $5.00 in free credits upon creation. No credit card required.

Sign up at platform.persly.ai
Start making API calls — free credits are applied automatically
When your balance runs low, purchase additional credits from the dashboard

How Credits Work

Credits are denominated in USD
Each API request deducts a fixed cost from your credit balance
If your credit balance cannot cover the request cost, the request is rejected with 402 and insufficient_credits
Free credits do not expire
Purchased credits do not expire

Billing amounts are denominated in USD.

Purchasing Credits

Purchase credits at platform.persly.ai. Credits are added to your balance immediately after payment.

Handling 402 Responses

A 402 response indicates insufficient credit balance. Purchase more credits to continue.

402 — Insufficient credits

{
  "error": {
    "message": "Insufficient credits. Please purchase credits to continue.",
    "type": "insufficient_credits",
    "code": "insufficient_credits",
    "param": null
  }
}

Pricing by Endpoint

API	Model	Cost
Chat	`persly-chat-v1`	$0.15/request (+$0.01 when the follow-up generation step is invoked, +$0.003/page for image/PDF attachments, up to 30 pages and 40MB/request)
Chat	`persly-chat-pro-v1`	$0.50/request (+$0.01 when the follow-up generation step is invoked, +$0.01/page for image/PDF attachments, up to 60 pages and 40MB/request)
Embeddings	`persly-embed-v1`	$0.30/1M tokens
Rerank	`persly-rerank-v1`	$15.00/1K searches
Finder	`persly-finder-v1` (basic)	$0.035/request
Finder	`persly-finder-v1` (advanced)	$0.07/request

With $5.00 in free credits, baseline capacity is approximately 33 persly-chat-v1 requests at base price ($0.15/request), or 140 Finder basic searches. Follow-up and attachment surcharges reduce chat request capacity.

Monitoring Usage

Track your spending and usage with near-real-time updates at platform.persly.ai:

View usage by endpoint, model, and date range
Monitor your credit balance
Purchase additional credits when needed
Download usage logs for successfully completed billable requests