InícioAPI VortixyAPI v1

API Vortixy

Integre o Vortixy Chat nos seus projetos com uma chave Bearer. Mesmas cotas do seu plano. Criar chave em Painel → Sua API

Mesmas cotas do seu plano Reset diário às 00:00 UTC

Visão geral

Vortixy é um espaço de trabalho tranquilo com IA para estudo, escrita, pesquisa, planejamento e trabalho do dia a dia. A API pública expõe o mesmo Chat que você usa em /chat para chamar da sua própria aplicação, script ou workspace. Cada chave herda os limites do seu plano atual — Free, Go $2, Pro $5 ou Max $9 — e todas as cotas são compartilhadas entre web e API.

URL base: https://www.vortixy.net/api/v1
Autenticação: Authorization: Bearer vtx_live_...
Tipo de conteúdo: application/json
Cotas: tokens, requisições, imagens, buscas web — igual ao seu plano (ver Painel)

Autenticação

Envie sua chave no header Authorization. Nunca exponha em código cliente ou 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. As chaves compartilham as cotas do seu plano.

POST /api/v1/chat

Envie uma mensagem com histórico de conversa opcional, ative a pesquisa web ou ajuste a profundidade de raciocínio. Conta para o limite diário de mensagens e tokens do seu plano.

Pronto para chatbots: adicione system para a persona do seu bot (8k chars), stream:true para deltas NDJSON, webSearch para fontes ao vivo. Cada chamada desconta tokens, requisições e buscas web — compartilhadas com a web (reset 00:00 UTC).

Campos da requisição — todas as variantes

Todos os campos JSON para POST /api/v1/chat. Apenas message é obrigatório — o resto é opcional.

Chat request fields
Campo	Tipo	Obrigatório	Descrição
message	string	yes	Mensagem do usuário (1–32.000 caracteres).
history	array	no	Turnos anteriores: [{ role: 'user' \| 'assistant', content: string }] (máx. 20).
system	string	no	Persona do bot / instruções (máx. 8k). Também aceita alias instructions.
provider	string	no	gemini (gerenciado, padrão). Para BYOK, salve sua chave em Dashboard → Configurações → Chaves de IA e use provider openai / anthropic / deepseek / gemini com um model id BYOK.
model	string	no	ID do modelo — veja a tabela abaixo. Deve ser permitido para seu provedor e plano.
thinkingLevel	enum	no	none \| low \| medium \| high \| xhigh \| max (xhigh/max apenas para GPT-5.6).
webSearch	boolean	no	true para ativar a busca web ao vivo. Conta na cota diária.
stream	boolean	no	true para streaming NDJSON (delta → done). Padrão false (JSON).

Dica: omita provider/model para usar o melhor modelo do seu plano. Use stream:true para chatbots.

Níveis de pensamento — todas as 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	Descrição
none	Sem raciocínio — mais rápido, menor uso de tokens.
low	Raciocínio leve — respostas rápidas com um pouco de reflexão.
medium	Raciocínio equilibrado — bom para a maioria das tarefas.
high	Raciocínio profundo — para análises e planejamentos complexos.
xhigh	Muito profundo — apenas modelos de fronteira, para problemas difíceis.
max	Máximo — usa todo o orçamento de raciocínio, mais lento e caro.

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
Modelo	Provedor	Access	Pensamento	Contexto
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.

Contexto e compactação automática

As janelas de contexto variam conforme o modelo e chegam a 1M (3.8/3.7) / 256k tokens. Cada solicitação também segue o limite do plano: Free 10k, Go 20k, Pro 35k ou Max 50k tokens. No Vortixy Chat (/chat), os turnos antigos são compactados automaticamente acima de 85% do orçamento aplicável. A API pública (/api/v1/chat) não mantém estado: guarde o histórico no seu app e reenvie-o em `history` a cada chamada.

Estimamos tokens com BPE para system + histórico + nova mensagem.
Se o total for ≤ 85% do orçamento do plano e do modelo, mantemos o histórico completo.
Se exceder, mantemos os turnos mais recentes que cabem em 80% do orçamento e compactamos os antigos em um resumo: “Earlier conversation (automatically compacted…)” com excertos de 260 caracteres.
Turnos recentes + system + nova mensagem sempre preservados; o resumo mantém fatos úteis dos turnos antigos. No /chat você verá um evento `context` (used/max, compacted, compactedMessages). Na API, você decide o que enviar em `history` — se enviar mais do que cabe (ex. 200k), o servidor retorna 400/429/502 em vez de aceitar silenciosamente.

O contexto útil por solicitação é o menor entre o limite do plano (10k/20k/35k/50k tokens) e a janela do modelo escolhido (até 1M (3.8/3.7) / 256k (demais)). Em integrações, envie apenas o histórico que caiba nesse orçamento e resuma os turnos antigos; solicitações grandes demais podem ser rejeitadas em vez de aceitas silenciosamente.

Exemplos — todas as 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}'

Streaming emite delta → done (NDJSON, Content-Type: application/x-ndjson). Com webSearch:true você também recebe fontes verificadas via busca web (conta na cota diária).

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

GET /api/v1/models

Lista modelos que seu plano atual pode usar (limitado por plano, sem custo de cota). Use para popular um seletor de modelos no seu 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 inclui apenas o modo Fast; Go, Pro e Max incluem os modos Fast, Smart e Auto — as cotas escalam com o plano (12k/50k/120k/250k tokens por dia, 5/20/50/100 respostas). Modelos BYOK precisam da sua chave e não aparecem aqui.

BYOK — use suas próprias chaves por APIBYOK via API

Traga sua própria chave de OpenAI, Anthropic, DeepSeek ou Gemini. Configure uma vez no app e use em todos os lugares — web e API compartilham as mesmas chaves salvas e as mesmas cotas diárias (reset 00:00 UTC).

1. No Vortixy, vá em Dashboard → Configurações → Chaves de IA e salve sua chave (OpenAI sk-..., Anthropic sk-ant-..., DeepSeek sk-..., ou Gemini AQ./AIza...). É criptografada (AES-256-GCM) e nunca exposta.
2. Chame POST /api/v1/chat com provider e model do catálogo BYOK (ex. provider: "openai", model: "gpt-5.6-terra" ou provider: "anthropic", model: "claude-opus-5").
3. Continue usando a mesma chave Bearer do Vortixy — a chave do provedor é resolvida no servidor. Cotas, streaming, thinkingLevel e webSearch funcionam igual para modelos gerenciados e BYOK.

Exemplo 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

Se a chave estiver faltando você recebe 403 byokMissing — adicione no Dashboard e tente novamente. Requisições BYOK também contam para tokens / solicitações / buscas do seu plano.

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

Gere imagens no modo padrão ou de qualidade. Conta para o limite diário de imagens do seu plano.

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" (rápido, baixo custo) ou "quality" (alta definição). Desconta da cota diária de imagens (Free 2/dia, Go 8, Pro 30, Max 60).

GET /api/v1/usage

Consulte seu plano atual e cotas restantes sem gastar 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

Defina webSearch: true para que Vortixy busque informações atualizadas da web quando útil. O modo pesquisa divide perguntas complexas em subconsultas paralelas e retorna fontes citadas.

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 (padrão, sem web) | true (busca avançada, 5 resultados, fontes citadas). Cada chamada true conta 1 para sua cota diária de buscas (Free 10/dia, Go 25/dia, Pro 50/dia, Max 100/dia).

Tasks & Projects

Mantenha-se organizado com Projetos e tarefas agendadas. Gerencie-os pelo Dashboard ou Chat — a API respeita os mesmos limites do plano para espaços, arquivos e tarefas.

Exemplo: diga no Chat "Lembre-me toda segunda às 9h de resumir minha semana" — Vortixy cria uma tarefa agendada que você pode ver no 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

Erros

Todos os erros seguem RFC 9457 com mensagem localizada. Verifique o campo code para tratamento programático.

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

API errors
Status	Code	When
400	validation	JSON inválido ou campo fora do intervalo
401	apiKeyInvalid	Chave Bearer ausente ou inválida
403	planRequired	Modelo não permitido para seu plano
403	byokMissing	Chave BYOK deste provedor não encontrada — salve-a em Dashboard → Configurações → Chaves de IA
429	quotaExceeded	Cota diária de tokens / requisições / buscas atingida
502	aiEngineFailed	Erro do modelo upstream

Cabeçalhos: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Retry-After, WWW-Authenticate on 401.

Início rápido (Node.js)

Copie, cole e execute. Node 18+ já tem fetch — sem pacote extra.

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

Testar no Chat →Obter chave API