AccueilAPI VortixyAPI v1

API Vortixy

Intégrez Vortixy Chat dans vos projets avec une seule clé Bearer. Mêmes quotas que votre forfait. Créer une clé dans Tableau de bord → Votre API

Mêmes quotas que votre forfait Réinitialisation quotidienne à 00:00 UTC

Aperçu

Vortixy est un espace de travail IA calme pour étudier, écrire, faire des recherches, planifier et travailler au quotidien. L’API publique expose le même Chat que vous utilisez sur /chat afin que vous puissiez l’appeler depuis votre propre app, script ou espace de travail. Chaque clé hérite des limites de votre forfait actuel — Free, Go $2, Pro $5 ou Max $9 — et tous les quotas sont partagés entre web et API.

URL de base : https://www.vortixy.net/api/v1
Auth : Authorization: Bearer vtx_live_...
Type de contenu : application/json
Quotas : tokens, requêtes, images, recherches web — identiques à votre forfait (voir Tableau de bord)

Authentification

Envoyez votre clé dans l’en-tête Authorization. Ne l’exposez jamais dans le code client ou les 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. Les clés partagent les quotas de votre forfait.

POST /api/v1/chat

Envoyez un message avec un historique optionnel, activez la recherche web ou ajustez la profondeur de réflexion. Décompté du quota quotidien de messages et de tokens de votre plan.

Prêt pour chatbot : ajoutez system pour la persona de votre bot (8k chars), stream:true pour les deltas NDJSON, webSearch pour des sources live. Chaque appel déduit tokens, requêtes et recherches web — partagés avec le web (reset 00:00 UTC).

Champs de la requête — toutes les variantes

Tous les champs JSON pour POST /api/v1/chat. Seul message est requis — le reste est optionnel.

Chat request fields
Champ	Type	Requis	Description
message	string	yes	Message utilisateur (1–32 000 caractères).
history	array	no	Tours précédents : [{ role: 'user' \| 'assistant', content: string }] (max 20).
system	string	no	Persona du bot / instructions (max 8k). Accepte aussi l'alias instructions.
provider	string	no	gemini (géré, par défaut). Pour le BYOK, enregistrez votre clé dans Dashboard → Paramètres → Clés IA, puis utilisez provider openai / anthropic / deepseek / gemini avec un model id BYOK.
model	string	no	ID modèle — voir tableau ci-dessous. Doit être autorisé pour votre provider + plan.
thinkingLevel	enum	no	none \| low \| medium \| high \| xhigh \| max (xhigh/max seulement pour GPT-5.6).
webSearch	boolean	no	true pour activer la recherche web en direct. Compte dans le quota quotidien.
stream	boolean	no	true pour streaming NDJSON (delta → done). Défaut false (JSON).

Astuce : omettez provider/model pour utiliser le meilleur modèle de votre plan. Mettez stream:true pour les chatbots.

Niveaux de réflexion — toutes les variantes

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	Description
none	Sans réflexion — le plus rapide, consommation minimale.
low	Réflexion légère — réponses rapides avec un peu de réflexion.
medium	Réflexion équilibrée — bon pour la plupart des tâches.
high	Réflexion profonde — pour analyses et planification complexes.
xhigh	Très profond — modèles frontières uniquement, pour problèmes difficiles.
max	Maximum — utilise tout le budget de réflexion, le plus lent et coûteux.

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
Modèle	Fournisseur	Access	Réflexion	Contexte
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.

Contexte et compactage automatique

Les fenêtres de contexte varient selon le modèle et atteignent 1M (3.8/3.7) / 256k tokens. Chaque requête est aussi limitée par le forfait : Free 10k, Go 20k, Pro 35k ou Max 50k tokens. Au-delà de 85% du budget applicable, les anciens tours sont automatiquement compactés. L’API publique est sans état : renvoyez l’historique dans `history` à chaque appel.

Nous estimons les tokens en BPE pour system + historique + nouveau message.
Si le total est ≤ 85% du budget du forfait et du modèle, nous gardons tout l’historique.
Si dépassement, nous gardons les tours les plus récents tenant dans 80% du budget et compactons les anciens en un résumé : « Earlier conversation (automatically compacted…) » avec extraits de 260 caractères.
Tours récents + system + nouveau message toujours préservés ; le résumé garde les faits utiles. Dans /chat vous verrez un événement `context` (used/max, compacted, compactedMessages). Sur l'API, vous choisissez quoi envoyer dans `history` — si vous envoyez plus que la capacité (ex. 200k), le serveur renvoie 400/429/502 au lieu d'accepter silencieusement.

Le contexte utile est la plus petite valeur entre la limite du forfait (10k/20k/35k/50k tokens) et la fenêtre du modèle (jusqu’à 1M (3.8/3.7) / 256k). Pour une intégration, n’envoyez que l’historique compatible et résumez les anciens tours ; une requête trop volumineuse peut être refusée.

Exemples — toutes les variantes

// 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}'

Le streaming émet delta → done (NDJSON, Content-Type: application/x-ndjson). Avec webSearch:true vous recevez aussi les sources ancrées via recherche web (compte dans le quota quotidien).

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

GET /api/v1/models

Liste les modèles que votre forfait peut utiliser (limités par plan, sans coût de quota). Servez-vous en pour un sélecteur de modèles dans votre 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 inclut uniquement le mode Fast ; Go, Pro et Max incluent les modes Fast, Smart et Auto — les quotas évoluent avec le plan (12k/50k/120k/250k tokens par jour, 5/20/50/100 requêtes). Les modèles BYOK nécessitent votre clé et ne sont pas listés ici.

BYOK — utilisez vos propres clés via APIBYOK via API

Apportez votre propre clé OpenAI, Anthropic, DeepSeek ou Gemini. Configurez une fois dans l'app et utilisez partout — web et API partagent les mêmes clés enregistrées et les mêmes quotas quotidiennes (reset 00:00 UTC).

1. Dans Vortixy, allez dans Dashboard → Paramètres → Clés IA et enregistrez votre clé (OpenAI sk-..., Anthropic sk-ant-..., DeepSeek sk-..., ou Gemini AQ./AIza...). Elle est chiffrée (AES-256-GCM) et jamais exposée.
2. Appelez POST /api/v1/chat avec provider et model du catalogue BYOK (ex. provider: "openai", model: "gpt-5.6-terra" ou provider: "anthropic", model: "claude-opus-5").
3. Continuez à utiliser la même clé Bearer Vortixy — la clé fournisseur est résolue côté serveur. Quotas, streaming, thinkingLevel et webSearch fonctionnent pareil pour modèles gérés et BYOK.

Exemple BYOK

# 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

Si la clé manque vous recevez 403 byokMissing — ajoutez-la dans le Dashboard et réessayez. Les requêtes BYOK comptent aussi pour les tokens / requêtes / recherches de votre 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

Générez des images en mode standard ou qualité. Décompté du quota d'images quotidien de votre plan.

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" (rapide, peu coûteux) ou "quality" (haute qualité). Déduit du quota quotidien d’images (Free 2/j, Go 8, Pro 30, Max 60).

GET /api/v1/usage

Vérifiez votre forfait actuel et vos quotas restants sans dépenser de tokens.

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

Ajoutez webSearch: true pour que Vortixy récupère des informations récentes du web si nécessaire. Le mode recherche décompose les questions complexes en sous-requêtes parallèles et renvoie des sources citées.

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 (défaut, sans web) | true (recherche avancée, 5 résultats, sources citées). Chaque appel true compte 1 pour votre quota quotidien de recherches (Free 10/jour, Go 25/jour, Pro 50/jour, Max 100/jour).

Tasks & Projects

Restez organisé avec des Projets et des tâches planifiées. Gérez-les depuis le Dashboard ou le Chat — l'API respecte les mêmes limites de plan pour les espaces, fichiers et tâches.

Exemple : dites dans le Chat « Rappelle-moi chaque lundi à 9 h de résumer ma semaine » — Vortixy crée une tâche planifiée visible dans le Dashboard.

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

Erreurs

Toutes les erreurs suivent la RFC 9457 avec un message localisé. Vérifiez le champ code pour un traitement programmatique.

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

API errors
Status	Code	When
400	validation	JSON invalide ou champ hors limites
401	apiKeyInvalid	Clé Bearer manquante ou invalide
403	planRequired	Modèle non autorisé pour votre forfait
403	byokMissing	Clé BYOK manquante pour ce fournisseur — enregistrez-la dans Dashboard → Paramètres → Clés IA
429	quotaExceeded	Quota quotidien tokens / requêtes / recherches atteint
502	aiEngineFailed	Erreur modèle amont

En-têtes : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Retry-After, WWW-Authenticate on 401.

Démarrage rapide (Node.js)

Copiez, collez et exécutez. Node 18+ a déjà fetch — aucun paquet supplémentaire.

// 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"])

Essayer dans Chat →Obtenir une clé API