ph0ny

Appearance

Pricing ​

ph0ny uses a credit-based billing system. One credit has a $0.001 list value; Pro and Scale use the tier-specific effective values shown by the pricing API.

Plans and rates ​

See the live plan comparison for monthly prices, included credits, overage rates, and carryover. These values come from the same plan catalog used by checkout. The public pricing API returns the current plan catalog and the retail TTS/STT model rates:

bash
curl https://api.ph0ny.com/v1/pricing

Each TTS/STT row includes creditsPerUnit, per, minimumCredits, and measureRounding. Credits charged are max(minimumCredits, round(measure / per * creditsPerUnit)); STT rounds audio up to a whole minute with a one-minute minimum. Model availability and rates can change, so use this response rather than a copied provider table for estimates. To check the authenticated model catalog for your account:

bash
curl https://api.ph0ny.com/v1/audio/models \
  -H "Authorization: Bearer $PH0NY_API_KEY"

When your own provider credential pays for the vendor that actually serves a request, that vendor usage bypasses ph0ny credit deduction. A supplied key for another vendor or a model running on ph0ny infrastructure does not make the request BYOK. See Authentication for API keys.

Check Usage ​

bash
curl https://api.ph0ny.com/v1/usage \
  -H "Authorization: Bearer $PH0NY_API_KEY"

Representative fields (the response also includes tier and the current period):

json
{
  "credits": {
    "used": 1250,
    "included": 50000,
    "carryover": 0,
    "limit": 50000,
    "remaining": 48750,
    "overageAllowed": true,
    "overageRate": 0.001,
    "overageCredits": 0,
    "overageCost": 0
  },
  "breakdown": {
    "sttMinutes": 2,
    "ttsCharacters": 800,
    "ragQueries": 1,
    "llmTokens": 200
  },
  "requestCount": 342
}

Subscription Management ​

bash
# View current subscription
curl https://api.ph0ny.com/v1/billing/subscription \
  -H "Authorization: Bearer $PH0NY_API_KEY"

# Create checkout session (redirects to Stripe)
curl -X POST https://api.ph0ny.com/v1/billing/checkout \
  -H "Authorization: Bearer $PH0NY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "pro",
    "successUrl": "https://ph0ny.com/pricing?checkout=success",
    "cancelUrl": "https://ph0ny.com/pricing?checkout=cancel"
  }'

# Open billing portal (manage subscription, invoices)
curl -X POST https://api.ph0ny.com/v1/billing/portal \
  -H "Authorization: Bearer $PH0NY_API_KEY"

Checkout accepts redirect URLs only on the API or portal hosts configured by ph0ny. An arbitrary application domain returns HTTP 400; use the developer portal's Billing page for the normal checkout flow.

Built by ph0ny.