Build against route aliases, not provider trivia.

CPEN follows the OpenRouter integration pattern: one base URL, OpenAI-compatible chat requests, model/router aliases, credits, and route metadata in responses.

Authentication

OAuth signup grants the launch credit path. Paid API calls use cpen_live API keys issued from the account dashboard.

Authorization: Bearer cpen_live_...

Price caps

Caps are declared in USD. CPEN rejects the request when no live provider group fits the cap.

"routing": {
  "currency": "USD",
  "max_input_per_1m": "0.03",
  "max_output_per_1m": "0.15"
}

Fees

The platform fee is 5%. Explicit data contribution opt-in reduces it to 4%.

upstream_cost + 5% fee
upstream_cost + 4% fee with opt-in

Extraction request

The extraction endpoint accepts text plus a JSON schema. Invalid JSON retry and real upstream execution are next implementation steps.

POST /v1/extractions
{
  "model": "cpen/auto-extract",
  "input": "Alice paid 12.50 USD for a notebook.",
  "schema": {"type": "object"},
  "routing": {
    "currency": "USD",
    "max_input_per_1m": "0.03",
    "max_output_per_1m": "0.15"
  }
}