Tema
Idioma

Ajuda e perguntas frequentes

Respostas curtas para perguntas comuns sobre a API do GetVibe: configuração do Codex Desktop, chaves de API, saldo, erros 401/402/403 e limites de solicitações.

Respostas curtas baseadas em solicitações reais de suporte: configuração do Codex, chaves, saldo, roteamento e limites.

Perguntas frequentes

Por que um modelo está ausente ou indisponível?

Use o ID de modelo público do catálogo, sem um sufixo interno do fornecedor. Se um modelo estiver temporariamente indisponível, tente outro modelo e repita mais tarde.

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
Por que vejo 403 Country, region, or territory not supported?

Isso geralmente tem uma de duas causas: o Codex Desktop ainda tem uma sessão ativa de Sign in with ChatGPT, ou o aplicativo não obteve a chave e enviou a solicitação para a OpenAI. Saia do ChatGPT, verifique as configurações do GetVibe e confirme que a solicitação aparece em Usage.

Um 403 Country, region, or territory not supported de api.openai.com significa que sua chave do GetVibe não foi utilizada, e não que o GetVibe está bloqueado no seu país.
Por que o aplicativo informa que a chave é inválida?

Verifique se a chave completa começa com sk-pv-, não contém espaços nem aspas, não foi revogada no dashboard e foi inserida no campo da chave da API. Um aplicativo com interface gráfica não recebe automaticamente uma variável do seu terminal.

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
Onde encontro uma chave de API e faço minha primeira solicitação?

Abra Dashboard → API keys, crie uma chave e copie-a uma única vez. Nunca envie a chave ao suporte, coloque-a em um chat ou faça commit dela no Git.

export GETVIBE_API_KEY="PASTE_YOUR_GETVIBE_KEY_HERE"
curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"Reply with one word: ready"}]}'
O que devo fazer se meu saldo for zero?

Adicione saldo no dashboard e tente a solicitação novamente. Repetir uma solicitação não pode corrigir um saldo zero ou insuficiente.

curl https://getvibeapi.com/v1/balance \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
Como posso saber para onde minha solicitação foi enviada?

Envie o id público do modelo ou uma variante :alias do catálogo. Depois de uma solicitação bem-sucedida, verifique se há um novo registro de Uso: uma resposta de um aplicativo de terceiros, por si só, não comprova que a solicitação passou pelo GetVibe.

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"
Quais são os limites de RPM e concorrência?

O limite acompanha seu saldo atual: 0 $ — 300 RPM e 10 solicitações simultâneas; a partir de 1 $ — 1,100 RPM e 50 solicitações simultâneas; a partir de 2 $ — 6,600 RPM e 300 solicitações simultâneas. O nível mais alto se aplica depois que o crédito da recarga é contabilizado e enquanto o saldo permanecer acima do limite correspondente.

O que significa um erro 402?

402 significa que não há saldo ou cota disponível para esta solicitação. Adicione saldo, verifique o preço do modelo e tente novamente. Não é um erro de chave de API nem um bloqueio por país.

Por que um parâmetro ou uma imagem não é compatível?

Os recursos dependem do modelo e do endpoint exatos. Consulte o catálogo para ver os parâmetros compatíveis; depois remova o campo incompatível ou escolha um modelo com o recurso necessário.

Links úteis

Ajuda e perguntas frequentes da GetVibe API — chaves, erros e limites | GetVibe API