Register as a provider

The Routeplane Registry is **experimental**. Pull requests are reviewed and merged case-by-case during this phase, and we reserve the right to reject or delist providers — see [Terms of Use](#terms-of-use) below. The end goal is fully permissionless onboarding; the current process exists to keep the network healthy while we get there.

The Routeplane Registry

Routeplane is designed as an open marketplace for inference. Anyone running an OpenAI- or Anthropic-compatible inference endpoint can apply to register their models — no commercial agreement, no sales cycle, no business form.

Provider listings live in a public, open-source repo:

github.com/routeplane/provider-registry

You apply by opening a pull request that adds your provider manifest. Once merged, Routeplane and any agent on the network can discover your models, route to them, and (optionally) pay you per request via x402/MPP.

How Registration Works

1. Fork provider-registry.
2. Add a manifest at providers/<your-provider-id>.yaml describing your endpoint and model catalog.
3. Open a PR. CI runs schema validation and basic reachability checks against your endpoint.
4. A maintainer reviews the PR. While we aim to merge openly, PRs are evaluated case-by-case during the experimental phase.
5. On merge, your models become discoverable across the Routeplane network and the hosted routeplane.app marketplace.

**Registry inclusion ≠ guaranteed traffic.** Being listed in the registry makes your models discoverable, but does not guarantee any volume of inference traffic. Routeplane runs an independent **router** that continuously monitors, scores, and ranks providers — see [Reliability & Routing](#reliability--routing) below. Traffic flows to providers that score well; weaker signals lead to deprioritization, regardless of registry status.

Provider Manifest

A manifest declares your endpoint metadata, payment modes, and the model-catalog URL that Routeplane polls.

id: example-provider
name: Example AI
endpoint: https://api.example.ai/v1
protocol: openai      # openai | anthropic
models_url: https://api.example.ai/v1/models
payment:
  modes: [byok, x402]
  x402_address: "0x..."          # optional, for hosted agent payments
homepage: https://example.ai
support: https://example.ai/support

Models Endpoint

Routeplane periodically polls your models_url and expects a list of all available models in the following schema.

{
  "data": [
    {
      "id": "example/sonnet-1",
      "name": "Example: Sonnet 1",
      "created": 1704067200,
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"],
      "context_length": 1000000,
      "max_output_length": 128000,
      "quantization": "fp8",
      "pricing": {
        "prompt": "0.000003",
        "completion": "0.000015",
        "image": "0",
        "request": "0",
        "input_cache_read": "0"
      },
      "supported_sampling_parameters": ["temperature", "top_p", "stop"],
      "supported_features": ["tools", "json_mode", "structured_outputs", "reasoning"],
      "is_ready": true
    }
  ]
}

Key fields:

• id — exact identifier Routeplane passes to your endpoint when routing requests.
• pricing — string-encoded USD per token to avoid floating-point drift. image and request are per unit.
• is_ready — set false to stage a model without making it live (useful for embargoed launches). Defaults to true.

Valid quantization: int4, int8, fp4, fp6, fp8, fp16, bf16, fp32.

Valid supported_features: tools, json_mode, structured_outputs, logprobs, web_search, reasoning.

Valid supported_sampling_parameters: temperature, top_p, top_k, min_p, top_a, frequency_penalty, presence_penalty, repetition_penalty, stop, seed, max_tokens, logit_bias.

Tiered Pricing

For long-context tiered pricing, supply pricing as an array. The first entry is the base tier; subsequent entries apply once input-token count reaches min_context.

{
  "pricing": [
    { "prompt": "0.000002", "completion": "0.000012" },
    { "prompt": "0.000004", "completion": "0.000018", "min_context": 200000 }
  ]
}

Deprecation

Set deprecation_date (ISO 8601, YYYY-MM-DD) on a model scheduled for retirement. Routeplane surfaces deprecation warnings to consumers and may auto-hide the model after that date.

Reliability & Routing

The registry tells Routeplane what models exist on your endpoint. The router decides how much traffic to send. They are separate systems.

The router continuously monitors uptime and performance per endpoint, then scores and ranks providers for every request. Scores update in real time — a provider that degrades will see traffic shift away within minutes.

Uptime — successful requests ÷ total requests, excluding user-input errors.

• Counts against uptime: 401, 402, 404, 5xx, mid-stream errors, success-with-error-finish-reason.
• Doesn’t count: 400, 413, 429, 403 (tracked separately).

Performance — TTFT (time to first token) and throughput (output tokens ÷ total generation time, including queue + fetch + streaming). Both are public on each model page.

To score well and receive traffic:

• Return early 429s when overloaded — don’t queue.
• Stream tokens as soon as they’re available.
• Send SSE keep-alive comments during long pre-token work (e.g. reasoning) so the router doesn’t time out and fall back.

Providers with consistently poor scores will be deprioritized. Providers that abuse the network or violate the Terms of Use below will be delisted entirely.

Payments

Providers can accept payment in three modes, declared in the manifest:

• byok — consumers bring their own API key for your service. Routeplane doesn’t intermediate payment.
• x402 — accept agent-native x402/MPP payments per request. Routeplane routes payment receipts to the address in your manifest.
• invoice — opt into invoiced billing for aggregated hosted-mode traffic.

Most new providers start with byok plus x402, then add invoice once volume warrants it.

Updating Your Listing

Manifest updates (new models, pricing changes, endpoint moves) are PRs to the registry. Pricing changes take effect on merge. To take a model offline, set is_ready: false in the next models-endpoint poll or open a PR removing it.

Terms of Use

By registering as a provider you agree to the following. Violations result in delisting from the registry and the hosted marketplace.

• No harmful content — endpoints must not be used to generate or knowingly facilitate CSAM, weapons-of-mass-destruction uplift, targeted harassment, or other content prohibited by applicable law.
• No malicious behavior — no credential harvesting, prompt-injection attacks against agents, response tampering, or covert data exfiltration.
• Honest metadata — the manifest and models endpoint must accurately reflect what your endpoint actually serves: pricing, context length, capabilities, modalities. Fraudulent metadata is grounds for immediate delisting.
• Reasonable availability — providers that consistently fail health checks or fail to respond to maintainer outreach may be delisted.
• Lawful operation — providers must comply with the laws of jurisdictions in which they operate, including export controls and sanctions where applicable.

We reserve the right to reject or delist any provider at our discretion during the experimental phase. As the network and tooling mature, we will narrow this discretion toward objective, automated criteria.

Get Help

• Open an issue on provider-registry.
• Join the Discord.