Introdução

A API Splita é REST + JSON. Endpoints versionados em /v1/ e compatíveis em /api/ai/openai/v1/ e /api/ai/anthropic/v1/. Base URL: https://api.splita.xyz.

Autenticação

Cada reseller gera uma API key com scopes específicos. Use header Authorization: Bearer sk_live_…. Chaves são exibidas apenas uma vez.

Authorization: Bearer sk_live_5pPq…
Content-Type: application/json

Scopes disponíveis: embed:create, usage:read, downloads:read, products:read, webhooks:manage.

Criar embed session

POST/v1/embed/sessions
POST /api/v1/embed/sessions
Authorization: Bearer sk_live_…
Content-Type: application/json

{
  "externalUserId": "wp-user-123",
  "email": "cliente@example.com",
  "name": "Cliente Exemplo",
  "domain": "cliente-revendedor.com",
  "productId": "prod_artlist",
  "scopes": ["downloads:create", "usage:read"],
  "expiresInSeconds": 300,
  "singleUse": true
}

Resposta:

{
  "embedUrl": "https://splita.xyz/embed/start?token=embed_x91…",
  "expiresAt": "2026-06-11T12:05:00Z"
}

Usage & Downloads

GET/v1/usage
GET/v1/downloads
GET/v1/end-users/:externalUserId/activity

Filtre por período, produto e end-user. Resposta paginada com cursor.

Webhooks

POST/v1/webhook-endpoints

Eventos disponíveis: download.generated, quota.low, account.unhealthy, run.failed. Assinatura HMAC SHA-256 opcional no header X-Splita-Signature.

AI Gateway

POST/api/ai/openai/v1/chat/completions
POST/api/ai/anthropic/v1/messages
GET/api/v1/ai/usage/estimate
GET/api/v1/ai/quota/status

Compatível com SDKs oficiais OpenAI/Anthropic — basta apontar a base URL para Splita. Metering por tokens, custo estimado por org/end-user.