REST API

This public API reference is intentionally scoped to authentication and external API-key/JWT endpoints for model access. Internal dashboard-only endpoints are excluded.

API testing playground

Use this built-in tester like a lightweight Postman. Pick an exposed endpoint preset, edit request parts, send live calls, inspect headers/body, and reuse recent history.

Endpoint preset

Preset description

OpenAI-compatible chat completions endpoint.

Base URL

Method

Path

Resolved URL

https://veyra.tubox.cloud/v1/chat/completions

Auth mode

Bearer token or API key

cURL preview

bash

curl -X POST "https://veyra.tubox.cloud/v1/chat/completions" \
  -H "Authorization: Bearer <token-or-api-key>" \
  -H "Content-Type: application/json" \
  --data '{\n  "model": "gpt-5.4-mini",\n  "stream": false,\n  "messages": [\n    {\n      "role": "system",\n      "content": "You are concise."\n    },\n    {\n      "role": "user",\n      "content": "Write a FastAPI health endpoint."\n    }\n  ]\n}'

Response

Send a request to see status, headers, and response body.

History

No requests yet.

Base URL

plain

https://veyra.tubox.cloud

Authentication

Access tokens come from POST /v1/auth/login.
API keys use Authorization: Bearer veyra_sk_....
Both can call the same LLM endpoints if permissions/scopes allow it.

bash

curl -H "Authorization: Bearer <access_token>" https://veyra.tubox.cloud/v1/models
curl -H "Authorization: Bearer veyra_sk_xxx" https://veyra.tubox.cloud/v1/chat/completions

Endpoint directory

Method	Path	Auth	Purpose
POST	/v1/auth/register	None	Create a new user account with email/password credentials.
POST	/v1/auth/login	None	Authenticate user and return token pair or 2FA challenge.
POST	/v1/auth/verify-2fa	None	Complete login using the session_token from /auth/login and a TOTP code.
POST	/v1/auth/refresh	None	Rotate refresh token and issue new access/refresh token pair.
POST	/v1/auth/oauth/google	None	Exchange Google authorization code for Veyra token pair.
POST	/v1/auth/logout	Bearer access token	Revoke current session or all sessions for current user.
POST	/v1/auth/request-email-verification	None	Send or resend email verification link (non-enumerating response).
POST	/v1/auth/verify-email	None	Mark account email as verified using signed verification token.
POST	/v1/auth/password-reset/request	None	Send password reset email for known accounts.
POST	/v1/auth/password-reset/confirm	None	Reset account password using reset token and new password.
POST	/v1/auth/2fa/setup	Bearer access token (session auth only)	Generate TOTP secret/provisioning payload for authenticator enrollment.
POST	/v1/auth/2fa/enable	Bearer access token (session auth only)	Enable 2FA for account by validating TOTP code from setup phase.
POST	/v1/auth/change-password	Bearer access token (session auth only)	Change password, revoke sessions, and require re-login.
GET	/v1/auth/sessions	Bearer access token (session auth only)	Return active/revoked/expired session inventory with metadata.
DELETE	/v1/auth/sessions/{session_id}	Bearer access token (session auth only)	Revoke a specific user session by ID.
GET	/v1/models	Bearer access token or API key	List models available to current principal after plan/settings filtering.
POST	/v1/chat/completions	Bearer access token or API key	OpenAI-compatible chat completion endpoint with stream and non-stream modes.
POST	/v1/embeddings	Bearer access token or API key	Generate vector embeddings for one string or an array of strings.
POST	/v1/images/generations	Bearer access token or API key	Generate images from a prompt using configured image-capable model.
POST	/v1/audio/transcriptions	Bearer access token or API key	Transcribe uploaded audio via multipart/form-data request.
POST	/v1/help/contact	None	Submit Help Center support ticket that is forwarded to admin support inbox.

Detailed endpoint pages

Detailed request/response/error documentation has been split into dynamic endpoint pages. Use the REST API sub-navigation in the left sidebar or jump directly using the directory below.

Authentication

POST /v1/auth/register

Create a new user account with email/password credentials.

POST /v1/auth/login

Authenticate user and return token pair or 2FA challenge.

POST /v1/auth/verify-2fa

Complete login using the session_token from /auth/login and a TOTP code.

POST /v1/auth/refresh

Rotate refresh token and issue new access/refresh token pair.

POST /v1/auth/oauth/google

Exchange Google authorization code for Veyra token pair.

POST /v1/auth/logout