Skip to main content
Limits vary by plan. Session responses include the effective limits for that session.

Plan limits

PlanConcurrent sessionsMax session duration
Free12 minutes
Starter210 minutes
Launch1020 minutes
Scale5060 minutes
Exceeding a concurrency cap returns 429 quota_exceeded with error.code: "concurrent_sessions". For early capacity planning, estimate the concurrency budget by dividing daily active users by 250. Rarely, Protoface may rate-limit how quickly new sessions are created during ramp-up, but that does not reduce the plan’s concurrent session cap.

Sessions

LimitDefault
Idle timeout30 seconds without input audio
Metadata size8 KB
Create rate limit10 requests per minute per key
Idempotency window24 hours
If you send max_duration_seconds, Protoface applies the lower of your request and your plan limit.

Credits

Usage is rounded up to the nearest minute. One credit equals one rounded-up session minute. If the account has no usable credits, session creation returns 402 quota_exceeded with error.code: "insufficient_credit_balance". Free monthly credits do not roll over. Purchased credits roll over without expiry.

Metadata keys

metadata is customer-owned JSON. Keys beginning with _avatar. are managed by Protoface and are reserved for support-directed use.

Next

Errors

Error responses and retry behavior.

Usage

Inspect usage and credits.