Usage & Billing API

Returns token usage, cost summary, daily chart data, and model breakdown. Query parameters: start_date and end_date in YYYY-MM-DD format.

Returns request-level call history ordered by created_at DESC. Cursor pagination (non-offset, stable under concurrent writes). Each item includes id, created_at, model_id, model_name, api_key_name, total_tokens, cost_str, and status (success / failed / refunded). Response: { items, next_cursor, has_more }. Empty usage returns { items: [], has_more: false, next_cursor: "" } — never 404.

Returns plan, credit balance, platform fee rate, payment methods, and invoices.

Returns current credit balance available for API usage.

Creates a checkout session. credit_usd and currency are required; optional success_url and cancel_url override the redirect targets. The response includes order_id, checkout_url, and session_id.

Old field amount is kept as fallback for backward compatibility.

Returns the status of one payment order.

Lists payment orders. Query parameters: limit (default 20, max 100) and offset (default 0).

Generates an invoice or receipt document URL for a payment order. order_id is required; type can be invoice or receipt.