Billing

Skilleo subscription for developer access. GPU and model usage is billed separately by your connected providers (Usage).

New accounts start on trial. Checkout moves billing to active.

GET /v1/billing/plans

Public plan catalog. No auth required.

curl -s https://api.skilleo.org/v1/billing/plans

GET /v1/billing/status

Requires auth. Returns billing_status, billing_plan, paid, and related fields.

curl -s https://api.skilleo.org/v1/billing/status \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

POST /v1/billing/checkout

Start checkout. Returns 201 with checkout_url. Open that URL to complete payment.

curl -s -X POST https://api.skilleo.org/v1/billing/checkout \
  -H "Authorization: Bearer $SKILLEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"paddle","plan_id":"developer","return_url":"https://app.example.com/billing/complete"}'

Field	Description
provider	Checkout rail — value from your plan catalog
plan_id	Plan id from GET /v1/billing/plans
return_url	Where to send the user after checkout

Code	When
BILLING_NOT_CONFIGURED	Checkout unavailable on this deployment
VALIDATION_ERROR	Unknown provider or plan
PAYMENT_REQUIRED	Active subscription required for the route you called

SDK

plans = client.billing.plans()
status = client.billing.status()
checkout = client.billing.checkout(provider="paddle", plan_id="developer")
# Redirect user to checkout["data"]["checkout_url"]