Skip to main content
POST
Create a private provider

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Body

application/json
name
string
required

Provider name, shown in your activity, logs and Broadcast output. 2-64 letters, numbers, spaces, dots, underscores or hyphens. Cannot be changed later. Neither the name nor its slug may match a public provider name or slug (case-insensitive); other customers may use the same name.

Required string length: 2 - 64
Pattern: ^[A-Za-z0-9][A-Za-z0-9 ._-]*$
Example:

"Acme"

base_url
string

HTTPS base URL of an OpenAI-compatible API, used by private endpoints under this provider that set no URL of their own. Without it, each endpoint must set its own. Private, internal, metadata and OpenRouter hosts are rejected.

Minimum string length: 1
Example:

"https://inference.example.com/v1"

data_policy
object

Defaults to training on and retaining prompts, the most conservative declaration. Your own declaration; it applies to your own traffic and OpenRouter does not verify it.

Example:
display_name
string

Defaults to name.

Required string length: 1 - 80
Example:

"Acme"

slug
string

2-64 lowercase letters and numbers, separated by single hyphens. Cannot be changed later. Defaults to the name lowercased, with every run of other characters replaced by a hyphen (Acme Inference becomes acme-inference).

Required string length: 2 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"acme"

Response

The provider was created

data
object
required
Example: