HomeVortixy APIAPI v1

Vortixy API

Integreer Vortixy Chat in je projecten met één Bearer-sleutel. Zelfde quota als je abonnement. Sleutel aanmaken in Dashboard → Jouw API

Zelfde quota als je abonnement Dagelijkse reset om 00:00 UTC

Overzicht

Vortixy is een rustige AI-werkplek voor studie, schrijven, onderzoek, planning en dagelijks werk. De publieke API biedt dezelfde Chat die je op /chat gebruikt, zodat je hem vanuit je eigen app, script of workspace kunt aanroepen. Elke sleutel erft de limieten van je huidige abonnement — Free, Go $2, Pro $5 of Max $9 — en alle quota worden gedeeld tussen web en API.

Basis-URL: https://www.vortixy.net/api/v1
Auth: Authorization: Bearer vtx_live_...
Content-type: application/json
Quota: tokens, verzoeken, afbeeldingen, webzoekopdrachten — zelfde als je abonnement (zie Dashboard)

Authenticatie

Stuur je sleutel in de Authorization-header. Nooit blootstellen in clientcode of query-params.

curl https://www.vortixy.net/api/v1/chat \
  -H "Authorization: Bearer vtx_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"message":"Hello Vortixy"}'

Scopes: chat, images, search, tasks, usage. Sleutels delen de quota van je abonnement.

POST /api/v1/chat

Stuur een bericht met optionele gespreksgeschiedenis, schakel webzoeken in of pas de denk-diepte aan. Telt mee voor de dagelijkse bericht- en tokenlimiet van je abonnement.

Chatbot-klaar: voeg system toe voor je bot-persona (8k tekens), stream:true voor NDJSON-delta's, webSearch voor live bronnen. Elke call verbruikt tokens, requests en web-zoekopdrachten — gedeeld met web (reset 00:00 UTC).

Request-velden — alle varianten

Alle JSON-velden voor POST /api/v1/chat. Alleen message is verplicht — de rest is optioneel.

Chat request fields
Veld	Type	Vereist	Beschrijving
message	string	yes	Gebruikersbericht (1–32.000 tekens).
history	array	no	Vorige beurten: [{ role: 'user' \| 'assistant', content: string }] (max 20).
system	string	no	Bot-persona / instructies (max 8k). Accepteert ook alias instructions.
provider	string	no	gemini (beheerd, standaard). Voor BYOK sla je je sleutel op via Dashboard → Instellingen → AI-sleutels en gebruik je daarna provider openai / anthropic / deepseek / gemini met een BYOK-model-id.
model	string	no	Model-ID — zie tabel hieronder. Moet toegestaan zijn voor provider + abonnement.
thinkingLevel	enum	no	none \| low \| medium \| high \| xhigh \| max (xhigh/max alleen voor GPT-5.6).
webSearch	boolean	no	true voor live webzoeken. Telt mee voor dagelijkse zoekquota.
stream	boolean	no	true voor NDJSON-streaming (delta → done). Standaard false (JSON).

Tip: laat provider/model weg voor het beste model van je plan. Zet stream:true voor chatbots.

Thinking-niveaus — alle varianten

Reasoning is now automatic per mode — Fast uses low, Smart uses high, Auto chooses intelligently based on your question. You no longer need to pick a level. The API still accepts thinkingLevel but it is optional and overridden by the mode.

Thinking levels
Level	Beschrijving
none	Geen redenering — snelst, laagste tokenverbruik.
low	Lichte redenering — snelle antwoorden met wat nadenken.
medium	Gebalanceerd — goed voor de meeste taken.
high	Diepe redenering — voor complexe analyse en planning.
xhigh	Zeer diep — alleen frontier-modellen, voor moeilijke problemen.
max	Maximaal — gebruikt volledig thinking-budget, traagst en duurst.

Fast → low/medium, Smart → medium/high, Auto → chooses low→high per query. No user selector needed — the system is intelligent per moment.

Chat modes — Fast / Smart / Auto

Pick a mode, not a model. Vortixy routes intelligently to make the most of your quota — no need to choose a specific model. All modes share your plan quotas (00:00 UTC).

Chat modes
Mode	When to use	Thinking	Speed
Fast	Quick answers for simple tasks — fastest, most efficient.	low / medium	Fastest
Smart	Thorough reasoning for complex tasks — deeper, step-by-step.	medium / high	Thorough
Auto	Vortixy chooses the best mode automatically per question (heuristic, zero extra cost).	auto (low → high)	Auto-chooses

Smart has an animated glow when selected (shimmer border). Auto is the default — recommended for most tasks.

BYOK models — 4 providers, free-tier (no plan gate)

Save your provider key once in Dashboard → Settings → AI keys (AES-256-GCM encrypted, never exposed) — then call with provider + model. Same 00:00 UTC quotas as managed.

BYOK models
Model	Provider	Access	Thinking	Context
gemini-3.8-flash:byok	gemini	Free — needs key	none, low, medium, high	1049k
gemini-3.7-flash:byok	gemini	Free — needs key	none, low, medium, high	1049k
gemini-3.6-flash:byok	gemini	Free — needs key	none, low, medium, high	256k
gpt-5.6-sol	openai	Free — needs key	none, low, medium, high, xhigh, max	256k
gpt-5.6-terra	openai	Free — needs key	none, low, medium, high, xhigh, max	256k
gpt-5.6-luna	openai	Free — needs key	none, low, medium, high, xhigh, max	256k
claude-fable-5	anthropic	Free — needs key	none, high	256k
claude-opus-5	anthropic	Free — needs key	none, high	256k
claude-sonnet-5	anthropic	Free — needs key	none, high	256k
claude-haiku-4-5	anthropic	Free — needs key	none, high	200k
deepseek-v4-pro	deepseek	Free — needs key	none, high	256k
deepseek-v4-flash	deepseek	Free — needs key	none, high	256k

BYOK catalog: gpt-5.6-sol/terra/luna (openai), claude-opus-5/fable-5/sonnet-5/haiku-4-5 (anthropic), deepseek-v4-pro/flash (deepseek), gemini-3.8-flash:byok / gemini-3.7-flash:byok (gemini). All available on Free when key is present — no upgrade needed.

Context & automatische compactie

Contextvensters verschillen per model en lopen op tot 1M (3.8/3.7) / 256k (rest) tokens. Elk verzoek volgt ook je abonnementslimiet: Free 10k, Go 20k, Pro 35k of Max 50k tokens. Boven 85% van het geldende budget worden oudere beurten automatisch samengevat. De publieke API is stateless: stuur de geschiedenis bij elke aanroep opnieuw in `history`.

We schatten tokens met BPE voor system + geschiedenis + nieuw bericht.
Als het totaal ≤ 85% van het abonnements- en modelbudget is, houden we de volledige geschiedenis.
Bij overschrijding houden we de nieuwste beurten die in 80% van budget passen en compacteren we oudere tot één samenvatting: “Earlier conversation (automatically compacted…)” met 260-tekens excerpts.
Recente beurten + system + nieuw bericht altijd bewaard; samenvatting bewaart nuttige feiten. In /chat zie je een `context`-event (used/max, compacted, compactedMessages). Op de API kies jij wat je in `history` stuurt — stuur je meer dan past (bijv. 200k), dan geeft de server 400/429/502 in plaats van stil te accepteren.

De bruikbare context is de laagste van je abonnementslimiet (10k/20k/35k/50k tokens) en het modelvenster (tot 1M (3.8/3.7) / 256k (rest)). Stuur bij integraties alleen passende geschiedenis en vat oudere beurten samen; te grote verzoeken kunnen worden geweigerd.

Voorbeelden — alle varianten

// Basic — only required field
{ "message": "Explain quantum computing simply" }

// With system persona (chatbot) — 8k chars
{
  "message": "What do you sell?",
  "system": "You are a friendly shop assistant for Acme. Answer briefly in Spanish."
}

// With history — multi-turn conversation
{
  "message": "And what about entanglement?",
  "history": [
    { "role": "user", "content": "Hi" },
    { "role": "assistant", "content": "Hello! How can I help?" },
    { "role": "user", "content": "Explain quantum computing" }
  ]
}

// Full request — all variants together
{
  "message": "Latest AI breakthroughs with sources",
  "history": [{ "role": "user", "content": "Hi" }],
  "system": "You are Acme support. Be concise.",
  "provider": "gemini",          // managed (default) — BYOK dashboard-only for other providers
  "model": "gemini-3.5-flash",    // any available managed model from the table above
  "thinkingLevel": "high",        // none | low | medium | high | xhigh | max
  "webSearch": true,              // true = live web grounding + sources[]
  "stream": false                 // false = JSON, true = NDJSON deltas
}

// 200 OK — non-streaming response
{
  "answer": "Quantum computing uses qubits...",
  "model": "gemini-3.5-flash",
  "usage": { "tokensEstimated": 42, "tokensReserved": 42, "webSearch": true },
  "sources": [{ "title": "Quantum computing — Wikipedia", "url": "https://en.wikipedia.org/wiki/Quantum_computing" }],
  "plan": "pro"
}

// Streaming (NDJSON) — ideal for chatbots
const res = await fetch("https://www.vortixy.net/api/v1/chat", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.VORTIXY_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Hello!", system: "Be concise.", stream: true, thinkingLevel: "medium" })
});
for await (const line of res.body.pipeThrough(new TextDecoderStream()).pipeThrough(splitNDJSON())) {
  const evt = JSON.parse(line);
  if (evt.type === "delta") process.stdout.write(evt.delta);
  if (evt.type === "sources") console.log("sources", evt.sources);
  if (evt.type === "done") console.log("\nusage", evt.usage);
}

// curl variants — pick the one you need
// 1) Basic
curl -X POST https://www.vortixy.net/api/v1/chat -H "Authorization: Bearer $VORTIXY_API_KEY" -H "Content-Type: application/json" -d '{"message":"Hello"}'

// 2) With web search + high thinking
curl -X POST https://www.vortixy.net/api/v1/chat -H "Authorization: Bearer $VORTIXY_API_KEY" -H "Content-Type: application/json" -d '{"message":"Latest AI news","webSearch":true,"thinkingLevel":"high"}'

// 3) Chatbot persona + streaming (NDJSON)
curl -N -X POST https://www.vortixy.net/api/v1/chat -H "Authorization: Bearer $VORTIXY_API_KEY" -H "Content-Type: application/json" -d '{"message":"Hi","system":"You are Acme bot.","stream":true}'

Streaming stuurt delta → done (NDJSON, Content-Type: application/x-ndjson). Met webSearch:true krijg je ook geaarde bronnen via webzoeken (telt voor dagquota).

429 quota exceeded → Retry-After401 invalid key → WWW-Authenticate

GET /api/v1/models

Lijst modellen die je huidige plan kan gebruiken (plan-gated, zonder quota-kosten). Gebruik het voor een model-picker in je chatbot.

curl https://www.vortixy.net/api/v1/models -H "Authorization: Bearer vtx_live_..."

// 200 OK — example for Pro plan (more models on Max, fewer on Free)
{
  "plan": "pro",
  "defaultModel": "gemini-3.5-flash",
  "models": [
    { "id": "gemini-3.5-flash", "label": "Gemini 3.5 Flash", "provider": "gemini", "thinkingLevels": ["none","low","medium","high"] },
    { "id": "gemini-3.5-flash-lite", "label": "Gemini 3.5 Flash Lite", "provider": "gemini", "thinkingLevels": ["none","low","medium","high"] },
    { "id": "gemini-3.1-flash-lite", "label": "Gemini 3.1 Flash Lite", "provider": "gemini", "thinkingLevels": ["none","low","medium","high"] }
  ]
}

Note: gemini-3.8-flash/gemini-3.7-flash/gemini-3.6-flash temporarily paused (effective 3.5+lite) — example shows effective models only.

Free bevat alleen de Fast-modus; Go, Pro en Max bevatten Fast, Smart en Auto — quota schalen met het plan (12k/50k/120k/250k tokens per dag, 5/20/50/100 verzoeken). BYOK-modellen hebben je key nodig en staan hier niet.

BYOK — gebruik je eigen provider-sleutels via APIBYOK via API

Breng je eigen sleutel mee voor OpenAI, Anthropic, DeepSeek of Gemini. Eén keer configureren in de app en overal gebruiken — web en API delen dezelfde opgeslagen sleutels en dezelfde dagelijkse quota (reset 00:00 UTC).

1. Ga in Vortixy naar Dashboard → Instellingen → AI-sleutels en sla je sleutel op (OpenAI sk-..., Anthropic sk-ant-..., DeepSeek sk-..., of Gemini AQ./AIza...). Hij wordt versleuteld (AES-256-GCM) en nooit blootgesteld.
2. Roep POST /api/v1/chat aan met provider en model uit de BYOK-catalogus (bv. provider: "openai", model: "gpt-5.6-terra" of provider: "anthropic", model: "claude-opus-5").
3. Blijf dezelfde Bearer-sleutel van Vortixy gebruiken — de provider-sleutel wordt server-side opgelost. Quota, streaming, thinkingLevel en webSearch werken hetzelfde voor beheerde en BYOK-modellen.

BYOK-voorbeeld

# 1) Save your provider key once in Vortixy (Dashboard → Settings → AI keys)
#    OpenAI sk-..., Anthropic sk-ant-..., DeepSeek sk-..., Gemini AQ./AIza...

# 2) Call the API with the same Vortixy Bearer key, but specify the BYOK provider+model
curl https://www.vortixy.net/api/v1/chat \
  -H "Authorization: Bearer vtx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Explain quantum computing with deep reasoning",
    "provider": "openai",
    "model": "gpt-5.6-terra",
    "thinkingLevel": "high",
    "stream": false
  }'

# Anthropic example
curl https://www.vortixy.net/api/v1/chat \
  -H "Authorization: Bearer vtx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"message":"Write a haiku about the sea","provider":"anthropic","model":"claude-opus-5"}'

# DeepSeek example
curl https://www.vortixy.net/api/v1/chat \
  -H "Authorization: Bearer vtx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"message":"Solve this algorithm","provider":"deepseek","model":"deepseek-v4-pro","thinkingLevel":"high"}'

// JS — BYOK via Vortixy API (same quotas, same Bearer key)
const res = await fetch("https://www.vortixy.net/api/v1/chat", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.VORTIXY_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    message: "Deep research with my own OpenAI key",
    provider: "openai",
    model: "gpt-5.6-sol",
    thinkingLevel: "xhigh", // xhigh/max only on GPT-5.6 — works via BYOK
    webSearch: true,
    stream: false
  })
});
const data = await res.json();
// data.answer, data.sources, data.usage, data.model

Als de sleutel ontbreekt krijg je 403 byokMissing — voeg hem toe in Dashboard en probeer opnieuw. BYOK-verzoeken tellen ook mee voor tokens / verzoeken / zoekopdrachten van je plan.

BYOK catalog: gpt-5.6-sol / terra / luna (openai), claude-opus-5 / fable-5 / sonnet-5 / haiku-4-5 (anthropic), deepseek-v4-pro / flash (deepseek), gemini-3.8-flash:byok / gemini-3.7-flash:byok / gemini-3.6-flash:byok (gemini). Managed Gemini models stay available without BYOK.

POST /api/v1/images

Genereer afbeeldingen in standaard- of kwaliteitsmodus. Telt mee voor de dagelijkse beeldlimiet van je abonnement.

curl https://www.vortixy.net/api/v1/images \
  -H "Authorization: Bearer vtx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a cozy minimalist living room, warm light","quality":"quality"}'

{ "image": { "mimeType": "image/png", "base64": "..." }, "remaining": 49 }

quality: "standard" (snel, goedkoop) of "quality" (hoge detail). Telt voor dagelijkse beeldquota (Free 2/dag, Go 8, Pro 30, Max 60).

GET /api/v1/usage

Bekijk je huidige abonnement en resterende quota zonder tokens te verbruiken.

curl https://www.vortixy.net/api/v1/usage -H "Authorization: Bearer vtx_live_..."

{ "plan":"pro","limits":{"aiTokensPerDay":120000,"aiRequestsPerDay":50},"resetsInSeconds": 43200 }

Web Search & Research

Stel webSearch: true in zodat Vortixy live informatie van het web ophaalt wanneer dat helpt. In onderzoeksmodus worden complexe vragen opgesplitst in parallelle deelzoekopdrachten met geciteerde bronnen.

await fetch("https://www.vortixy.net/api/v1/chat", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.VORTIXY_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Latest AI breakthroughs with sources", webSearch: true })
});

webSearch: false (standaard, zonder web) | true (geavanceerd zoeken, 5 resultaten, geciteerde bronnen). Elke true-aanroep telt 1 voor je dagelijkse zoekquota (Free 10/dag, Go 25/dag, Pro 50/dag, Max 100/dag).

Tasks & Projects

Blijf georganiseerd met Projecten en geplande taken. Beheer ze via het Dashboard of de Chat — de API respecteert dezelfde planlimits voor ruimtes, bestanden en taken.

Voorbeeld: zeg in de Chat "Herinner me elke maandag om 9 uur om mijn week samen te vatten" — Vortixy maakt een geplande taak aan die je in het Dashboard kunt bekijken.

Chats — memoria guardada

Guarda conversaciones en Vortixy para no reenviar el historial cada vez. Mismo límite que tu plan (Free 30, Go 100, Pro 300, Max 400).

GET  /api/v1/chats          # lista tus chats
POST /api/v1/chats          # {title} -> crea uno
GET  /api/v1/chats/:id      # detalle
PATCH /api/v1/chats/:id     # {title} renombra
DELETE /api/v1/chats/:id
GET  /api/v1/chats/:id/messages?limit=50
POST /api/v1/chats/:id/messages  # {role, content}

// POST /api/v1/chats
{ "title": "Mi proyecto Tesis" }
// -> { "chat": { "id": "uuid", "title": "Mi proyecto Tesis" } }

// POST /api/v1/chats/uuid/messages
{ "role": "user", "content": "Hola" }

Files — subir documentos

Sube PDFs, Word, texto o imágenes (20 MiB) para usarlos luego en el chat. Cuenta como artefacto diario (Free 3/día, Go 10/día, Pro 25/día, Max 60/día).

curl https://www.vortixy.net/api/v1/files \
  -H "Authorization: Bearer vtx_live_..." -F file=@tarea.pdf

# JSON alternativo
curl -X POST https://www.vortixy.net/api/v1/files \
  -H "Authorization: Bearer vtx_live_..." -H "Content-Type: application/json" \
  -d '{"name":"tarea.pdf","mimeType":"application/pdf","base64":"..."}'

GET /api/v1/files?limit=20 -> { "files": [{ "id": "...", "name": "tarea.pdf" }] }

Projects — carpetas de estudio

Crea espacios con instrucciones fijas. Límites Free 1 / Go 3 / Pro 8 / Max 15.

GET  /api/v1/projects
POST /api/v1/projects  # {title, subject, instructions}
GET  /api/v1/projects/:id
PATCH /api/v1/projects/:id
DELETE /api/v1/projects/:id

Study Generate — Modo Examen

Genera flashcards o quiz desde un texto (Free 2/día, Go 5/día, Pro 12/día, Max 20/día). Luego puedes exportar a Anki.

curl https://www.vortixy.net/api/v1/study/generate \
  -H "Authorization: Bearer vtx_live_..." -H "Content-Type: application/json" \
  -d '{"content":"texto largo de apuntes...","kind":"flashcards","count":10}'

{ "kind": "flashcards", "items": [{ "front": "¿Qué es...?", "back": "Es..." }] }

POST /api/v1/chat/completions — compatible con OpenAI

Mismo chat pero con formato OpenAI: {messages:[{role,content}]}. Ideal para usar cualquier SDK de OpenAI cambiando solo la URL base a https://www.vortixy.net/api/v1.

// OpenAI SDK
import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://www.vortixy.net/api/v1",
  apiKey: process.env.VORTIXY_API_KEY
});
const res = await client.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [{role:"user", content:"Hola"}]
});
console.log(res.choices[0].message.content);

curl https://www.vortixy.net/api/v1/chat/completions \
  -H "Authorization: Bearer vtx_live_..." -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hola"}],"stream":false}'

API compatible con OpenAI (2026)

Vortixy expone un espejo 100% compatible con el formato de OpenAI Chat Completions (2026). Cambia solo baseURL y tu apiKey — el mismo código funciona con el SDK oficial de OpenAI, Vercel AI SDK, LangChain o cualquier cliente compatible. Streaming usa SSE estándar data: {...} + data: [DONE] (como OpenAI 2026). Las mismas cuotas del plan (tokens/requests/búsquedas) se comparten con /api/v1/chat.

// OpenAI JS SDK — sin cambiar lógica
import OpenAI from "openai";
const vortixy = new OpenAI({
  baseURL: "https://www.vortixy.net/api/v1",
  apiKey: process.env.VORTIXY_API_KEY, // vtx_live_...
});
const res = await vortixy.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [
    { role: "system", content: "Eres un tutor amable." },
    { role: "user", content: "Explícame fotosíntesis en 3 bullets" }
  ],
  stream: false,
  // web_search / webSearch también soportado (alias):
  // web_search: true
});
console.log(res.choices[0].message.content);
// res.usage => { prompt_tokens, completion_tokens, total_tokens }
// res.sources => [{title, url}] si webSearch:true

// Streaming SSE (igual que OpenAI 2026)
const stream = await vortixy.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [{ role: "user", content: "Hola" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

// Vercel AI SDK (2026)
import { createOpenAI } from "@ai-sdk/openai";
const vortixy = createOpenAI({
  baseURL: "https://www.vortixy.net/api/v1",
  apiKey: process.env.VORTIXY_API_KEY,
});
const { text } = await generateText({
  model: vortixy("gemini-3.5-flash"),
  prompt: "Resume este PDF en 5 puntos",
});

curl https://www.vortixy.net/api/v1/chat/completions \
  -H "Authorization: Bearer vtx_live_..." -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [{"role":"user","content":"Hola"}],
    "stream": false
  }'

# con búsqueda web (alias 2026 tolerante):
# "web_search": true  o  "webSearch": true  -> grounding Tavily + sources[]

# Python
# from openai import OpenAI
# client = OpenAI(base_url="https://www.vortixy.net/api/v1", api_key="vtx_live_...")
# res = client.chat.completions.create(model="gemini-3.5-flash", messages=[{"role":"user","content":"Hola"}])

Nota 2026: formato idéntico a OpenAI — id: chatcmpl-..., object: chat.completion, choices[0].message, usage y streaming data: {choices: [{delta: {content: "..."}}]} + data: [DONE]. Envelope SSE estándar (OpenAI-compatible). 401 sin Bearer, 429 con Retry-After/RateLimit-*.

Webhooks

Recibe avisos en tu servidor cuando algo pasa. Máx 5 por cuenta.

GET  /api/v1/webhooks          # lista
POST /api/v1/webhooks          # {url, events:["chat.completed","task.completed","quota.warning"]}
DELETE /api/v1/webhooks?id=uuid

OpenAPI

Spec completo en GET /api/v1/openapi para importar en Postman, Insomnia o generar SDK.

curl https://www.vortixy.net/api/v1/openapi

Fouten

Alle fouten volgen RFC 9457 met een gelokaliseerd bericht. Controleer het veld code voor programmatische afhandeling.

{ "error": "You reached the daily quota. Try again after 2h.", "code": "quotaExceeded", "retryAfter": 7200 }

API errors
Status	Code	When
400	validation	Ongeldige JSON of veld buiten bereik
401	apiKeyInvalid	Ontbrekende of ongeldige Bearer-sleutel
403	planRequired	Model niet toegestaan voor je abonnement
403	byokMissing	BYOK-sleutel voor deze provider ontbreekt — sla op in Dashboard → Instellingen → AI-sleutels
429	quotaExceeded	Dagelijkse quota tokens / requests / zoekopdrachten bereikt
502	aiEngineFailed	Upstream modelfout

Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Retry-After, WWW-Authenticate on 401.

Snelstart (Node.js)

Kopieer, plak en voer uit. Node 18+ heeft al fetch — geen extra pakket nodig.

// Node 18+ — no install needed
const res = await fetch("https://www.vortixy.net/api/v1/chat", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.VORTIXY_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    message: "Turn these notes into a plan: ...",
    system: "You are a concise assistant.",
    thinkingLevel: "medium",
    webSearch: false,
    stream: false
  })
});
const data = await res.json();
console.log(data.answer);

// Streaming chatbot
const streamRes = await fetch("https://www.vortixy.net/api/v1/chat", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.VORTIXY_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Hello!", stream: true })
});
for await (const chunk of streamRes.body) {
  // parse NDJSON lines: {type:"delta", delta:"..."} -> {type:"done", answer:"..."}
}

// Image
const imgRes = await fetch("https://www.vortixy.net/api/v1/images", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.VORTIXY_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "minimalist logo for Vortixy", quality: "quality" })
});
const { image } = await imgRes.json();
// image.base64 -> save as PNG

// Python — same API
// import requests
// r = requests.post("https://www.vortixy.net/api/v1/chat",
//   headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
//   json={"message": "Hello!", "thinkingLevel": "high", "webSearch": True})
// print(r.json()["answer"])

Probeer in Chat →API-sleutel ophalen