Skip to content

Platform

platform.v2.nairon.xyz is the control surface for a platform-type project — one whose “product” is Nairon’s API rather than a hotline. A project gets this surface when it’s created with type = platform; it has no flow editor or phone number management, since those concepts don’t apply. Instead you mint API keys, watch usage, and preview an invoice.

Nairon exposes two APIs plus an MCP server, all authenticated with project-scoped API keys minted from a platform-type project:

  • platform-api (api.v2.nairon.xyz) — an OpenAI-compatible data plane: chat completions, text-to-speech, transcription, realtime speech-to-speech, batch jobs, and knowledge-base stores. Point an OpenAI SDK’s base_url at it.
  • service-api (service.v2.nairon.xyz) — a REST control plane: flows/versions, phone numbers, agent profiles, usage reads. Also serves an MCP server at /mcp.
  • Guidequickstart, the platform console, API keys, usage & billing, and MCP.
  • Developer: platform-API guide — chat, speech, transcription, realtime, batch, and knowledge bases, with worked examples.
  • Developer: service-API for Platform — usage reads relevant to a platform-type project.

For the full endpoint reference, see API doc.