Documentação do Desenvolvedor

Bem-vindo ao Developer Hub da Nebula API. Aqui você encontrará tudo o que precisa para integrar nossas ferramentas de IA e Minecraft em suas aplicações.

Comece Agora

Você precisa de uma chave de API para começar. Acesse o Dashboard para criar sua conta gratuita.

Autenticação

A Nebula API usa chaves de API para autenticar requisições. Você pode passar sua chave através do cabeçalho HTTP Authorization ou X-API-Key.

Via Bearer Token (Recomendado)

curl -H "Authorization: Bearer SUA_CHAVE_AQUI" \
  https://nebulaapi.com.br/api/auth/me

Via Header X-API-Key

curl -H "X-API-Key: SUA_CHAVE_AQUI" \
  https://nebulaapi.com.br/api/auth/me

Limites de Uso (Rate Limiting)

Para garantir a estabilidade do serviço, aplicamos limites de taxa em todas as requisições. O plano gratuito possui limites específicos por endpoint (ex: 10 req/min para texto, 3 req/min para imagem).

Você pode verificar seu consumo através dos cabeçalhos de resposta:

  • X-RateLimit-Limit: Seu limite total.
  • X-RateLimit-Remaining: Requisições restantes na janela atual.
  • X-RateLimit-Reset: Segundos até o reset do limite.

Erros

A API utiliza códigos de status HTTP padrão para indicar o sucesso ou falha de uma requisição.

200 OK Sucesso.
400 Bad Request Sua requisição está mal formatada ou faltando parâmetros.
401 Unauthorized Chave de API inválida ou ausente.
429 Too Many Requests Você excedeu seu limite de taxa.
500 Internal Server Error Algo deu errado do nosso lado.