OpenQlik API

A unified REST surface for voice agents, speech, chat, vision, media, and knowledge base. All endpoints are platform-managed — sign up, mint an API key, and start calling.

Authentication

Pass your key in the Authorization header. Keys look like oqk_live_….

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

Speech

POST
/v1/ttsText → Speech

Synthesize speech from text using a platform-managed voice.

POST
https://openqlik.lovable.app/api/v1/tts
POST
/v1/sttSpeech → Text

Transcribe an audio file. Send as multipart/form-data with field `file`.

POST
https://openqlik.lovable.app/api/v1/stt
POST
/v1/voice-changerVoice → Voice

Re-speak an audio clip in a different voice (speech-to-speech). Multipart form-data.

POST
https://openqlik.lovable.app/api/v1/voice-changer
POST
/v1/speech-to-speechSpeech → Reply (STT + LLM + TTS)

Unified voice pipeline: transcribe user audio, generate a reply via the AI gateway, and return spoken audio in one blocking call. Transcript, reply text, and per-stage latencies are returned via X-* response headers (CORS-exposed).

POST
https://openqlik.lovable.app/api/v1/speech-to-speech

Text & Vision

POST
/v1/text-to-textGenerate text

Send a prompt to the self-hosted AI gateway and receive the generated response.

POST
https://openqlik.lovable.app/api/v1/text-to-text
POST
/v1/images/generationsGenerate images

Image generation. Disabled in this deployment — the self-hosted AI gateway does not expose an image-generation endpoint.

POST
https://openqlik.lovable.app/api/v1/images/generations
POST
/v1/visionImage understanding

Image understanding. Disabled in this deployment — the self-hosted AI gateway does not expose a vision endpoint.

POST
https://openqlik.lovable.app/api/v1/vision

Media

POST
/v1/sfxSound effects

Generate a short sound effect from a text prompt.

POST
https://openqlik.lovable.app/api/v1/sfx
POST
/v1/musicMusic generation

Generate a music track from a text prompt.

POST
https://openqlik.lovable.app/api/v1/music
POST
/v1/isolatorVoice isolator

Strip background noise from an audio clip.

POST
https://openqlik.lovable.app/api/v1/isolator
POST
/v1/dubbingDub video/audio

Translate spoken audio to a target language while preserving voice.

POST
https://openqlik.lovable.app/api/v1/dubbing

Agents

GET
/v1/agentsList agents

List your tenant's agents, most recent first.

GET
https://openqlik.lovable.app/api/v1/agents
POST
/v1/agentsCreate agent

Create a new voice agent.

POST
https://openqlik.lovable.app/api/v1/agents
GET
/v1/agents/{agent_id}Get agent

Retrieve a single agent by id.

GET
https://openqlik.lovable.app/api/v1/agents/%7Bagent_id%7D
PATCH
/v1/agents/{agent_id}Update agent

Patch one or more fields on an existing agent. Omitted fields stay unchanged.

PATCH
https://openqlik.lovable.app/api/v1/agents/%7Bagent_id%7D
DELETE
/v1/agents/{agent_id}Delete agent

Permanently delete an agent. Returns 204 on success.

DELETE
https://openqlik.lovable.app/api/v1/agents/%7Bagent_id%7D
POST
/v1/agents/{agent_id}/converseConverse with agent

Full STT → LLM → TTS turn. Send JSON `{text}` for text-in, or multipart/form-data with `file` for audio-in.

POST
https://openqlik.lovable.app/api/v1/agents/%7Bagent_id%7D/converse

Knowledge Base

GET
/v1/kb/documentsList documents

List knowledge base documents. Pass `org_id` to scope to an organization (caller must be a member); omit it to list the API key owner's personal documents. Supports pagination via `limit`/`offset` and filename search via `q`.

GET
https://openqlik.lovable.app/api/v1/kb/documents
POST
/v1/kb/documentsCreate document

Add a knowledge base document. The body is chunked and indexed for `kb/search`.

POST
https://openqlik.lovable.app/api/v1/kb/documents
POST
/v1/kb/searchSemantic search

Search across the tenant's knowledge base. Pass `org_id` to search an organization's documents (caller must be a member); omit for personal documents. Supports pagination via `top_k` (page size) and `offset`.

POST
https://openqlik.lovable.app/api/v1/kb/search
GET
/v1/kb/documents/{document_id}Get document

Retrieve a single knowledge-base document, including its full content.

GET
https://openqlik.lovable.app/api/v1/kb/documents/%7Bdocument_id%7D
PATCH
/v1/kb/documents/{document_id}Update document

Patch fields on an existing document. Re-chunks when `content` is supplied.

PATCH
https://openqlik.lovable.app/api/v1/kb/documents/%7Bdocument_id%7D
DELETE
/v1/kb/documents/{document_id}Delete document

Permanently remove a knowledge-base document. Returns 204.

DELETE
https://openqlik.lovable.app/api/v1/kb/documents/%7Bdocument_id%7D