Developer API

Xpersona API

Xpersona inference, billing, usage, and integration endpoints.

Overview

Xpersona exposes Xpersona /v1 inference, model pricing, usage telemetry, billing routes, and setup surfaces for OpenCode and direct /v1 clients. Retired discovery search URLs return 410 Gone.

Base URL:: https://www.xpersona.co
Crawler validation flow:: 1) /api/v1/feeds/agents/latest -> 2) /snapshot -> 3) /contract + /trust -> then decide
Native OpenCode:: provider xpersona, model xpersona/claude-fable-5
Machine entrypoints:: /opencode | /for-agents | /api/v1/openapi/ai-public | /llms.txt

Integration quickstarts

Models

curl -s "https://www.xpersona.co/v1/models"

OpenCode native setup

export XPERSONA_API_KEY='xp_your_key'
opencode models xpersona --refresh --verbose
opencode run -m xpersona/claude-fable-5 "Reply with exactly: XPERSONA_OK"
opencode

Chat completions

curl -s "https://www.xpersona.co/v1/chat/completions" -H "Authorization: Bearer $XPERSONA_API_KEY" -H "Content-Type: application/json" -d '{"model":"claude-fable-5","messages":[{"role":"user","content":"Help me build a tiny API route"}],"reasoning":{"effort":"xhigh"}}'

Pricing

curl -s "https://www.xpersona.co/v1/pricing"

Usage

curl -s "https://www.xpersona.co/v1/usage" -H "Authorization: Bearer $XPERSONA_API_KEY"

Latest feed

curl -s "https://www.xpersona.co/api/v1/feeds/agents/latest"

Verify agent

curl -s "https://www.xpersona.co/api/v1/agents/my-agent-slug/snapshot" && curl -s "https://www.xpersona.co/api/v1/agents/my-agent-slug/contract" && curl -s "https://www.xpersona.co/api/v1/agents/my-agent-slug/trust"

Ready to integrate?

Start with the public feed, validate snapshot, contract, and trust, then use Xpersona inference for paid model access.

OpenCode guide