Documentação / Referência da API Referência da API — todos os endpoints A lista completa de endpoints da GetVibe API, com método, caminho, descrição e tipo de autenticação. Os endpoints são agrupados por categoria. O endereço base de /v1/* é https://getvibeapi.com/v1; para /api/*, é https://getvibeapi.com.
Uma especificação OpenAPI 3.0 legível por máquina está disponível em
/api/openapi — importe-a para o Postman, Swagger UI ou qualquer ferramenta compatível com OpenAPI.
Os catálogos públicos /api/catalog, /api/media-catalog estão disponíveis sem uma chave — use-os para vitrines, cálculos de preço e descoberta de modelos antes de se cadastrar.
Método Endpoint Descrição Auth POST /v1/chat/completions Endpoint de chat compatível com OpenAI. BearerPOST /v1/messages Endpoint no formato Anthropic Messages. O caminho para o Claude Code e o SDK da Anthropic. x-api-key / BearerPOST /v1/responses OpenAI Responses API. O caminho para o Codex CLI (wire_api = "responses"). BearerPOST /v1/messages/count_tokens Endpoint simulado de contagem de tokens para o SDK da Anthropic / Claude Code (uma estimativa, não um tokenizador exato). x-api-key / Bearer
Método Endpoint Descrição Auth GET /v1/models Modelos disponíveis com tipo, modalidades e endpoints. Mídia sob demanda: ?type=image, ?all=true ou /v1/models/all; um modelo: /v1/models/{id}. BearerGET /v1/pricing Fonte programática canônica de preços para modelos de texto, incluindo substituições ativas do operador. BearerPOST /v1/embeddings Embeddings de texto para pesquisa, RAG e clustering. BearerPOST /v1/decisionsAvalia perguntas nomeadas em relação a um estado (texto->decisões). Não é um endpoint de chat; cobra apenas os tokens de entrada. Bearer
Método Endpoint Descrição Auth POST /api/media/generate Geração assíncrona de mídia (imagem/vídeo/áudio/música/3d). Retorna um jobId para consulta. BearerGET /api/media/jobs/{id} Consulte o status de um job assíncrono de geração de mídia. BearerGET /api/media/file/{id}/{idx} URL de proxy assinada para um resultado (HMAC no parâmetro de consulta sig). Sem chave — para incorporar em <img>/<video>. sig (HMAC)GET /api/media-catalog Catálogo público de modelos de mídia: tipo, variantes, parâmetros, fromRub, eixos. public
Método Endpoint Descrição Auth GET /v1/balance Saldo pré-pago restante em USD. BearerGET /v1/generations Histórico de uso com route / address_as (rota pública), request_id e paginação. BearerGET /v1/generations/{id} Uma única entrada do histórico de uso por id (da resposta de /v1/generations ou do cabeçalho x-pv-generation-id). BearerGET /v1/usage Estatísticas de uso por chave com os campos route e address_as. BearerGET /api/key/usage Resumo por chave: saldo, gastos de hoje/mês, contagem de solicitações. Bearer / x-api-key
Método Endpoint Descrição Auth ANY x-getvibe-route / x-getvibe-model Cabeçalhos de resposta apenas para clientes confiáveis de revelação/depuração: o :alias público e o address_as da rota vencedora. response headers
Método Endpoint Descrição Auth GET /v1/keysLista de chaves de API da conta. BearerPOST /v1/keysNão disponível pela API. Crie e gerencie chaves somente no dashboard (seção Keys). — (UI only)
Método Endpoint Descrição Auth POST /v1/tickets Abra um chamado de suporte (JSON ou multipart com capturas de tela). Chave de API ou sessão do dashboard. BearerGET /v1/tickets Liste seus tickets, do mais recente para o mais antigo, com paginação por cursor. BearerGET /v1/tickets/{id} Status do ticket e a thread completa com as respostas do suporte. BearerPOST /v1/tickets/{id}/messages Adicione uma mensagem de acompanhamento ao seu ticket. BearerPOST /v1/tickets/{id}/close Feche seu ticket. BearerPOST /v1/technical-feedback Alias legado de POST /v1/tickets para relatórios técnicos; mesmos campos de antes. Bearer
Método Endpoint Descrição Auth GET /api/webhooks URLs atuais de webhook (mediaWebhookUrl, balanceWebhookUrl). Somente a sessão do Dashboard. session (dashboard)PATCH /api/webhooks Defina ou limpe mediaWebhookUrl / balanceWebhookUrl. Apenas a sessão do painel. session (dashboard)
Método Endpoint Descrição Auth GET /api/catalogCatálogo público de modelos de texto (sem autenticação). Usado pelo site para a vitrine. publicGET /api/media-catalog Catálogo público de modelos de mídia (tipos, preços por unidade, parâmetros, eixos). public
