Docs | Vaelor

The Vaelor API gives you programmatic access to the same models and tools that power the Vaelor workspace: streamed chat across three model tiers, image and music generation, file handling, and long-running OSINT investigations. Every request draws from the same credit balance as your account.

Shell

curl https://api.vaelor.chat/v1/chat \
  -H "Authorization: Bearer $VAELOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Summarize the plot of Hamlet in three sentences.", "attachments": [], "config": {"model": "flash", "modes": [], "uncensored": false}}'

Start here#

Quickstart

Create a key and stream your first response in about two minutes.

Authentication

Bearer keys, where to create them, and how to keep them safe.

Models

Pick between Flash, Medium and High, and turn on reasoning.

Credits & billing

How every request is reserved, settled and refunded.

API reference#

Chat

Streamed text generation with attachments, context and research modes.

Images

Text-to-image in square, landscape and portrait at two quality levels.

Music

Full songs or instrumentals from 30 seconds to over 8 minutes.

OSINT

Durable, auditable investigations that run in the background.

Base URL#

All endpoints live under a single versioned base URL. Requests must use HTTPS; plain HTTP is rejected.

Text

https://api.vaelor.chat/v1

Request bodies are JSON unless an endpoint says otherwise (file uploads use multipart/form-data). Responses are JSON, except for streamed endpoints, which are described in Streaming.

Versioning#

The current version is v1. We add fields and endpoints without changing the version, so build your client to ignore fields it doesn't recognize. Breaking changes ship under a new version prefix, and the previous version keeps working for at least 12 months after the announcement.

Using Vaelor without code?

The guides cover the workspace itself: long drafts, images, uncensored mode and how your history is stored.