Skip to main content
O Novita AI oferece APIs de modelos hospedados, sandboxes de agente e infraestrutura de GPU. Siga o caminho que corresponde à sua tarefa e verifique um resultado funcional antes de avançar para os guias mais detalhados.
Se você tiver dúvidas, consulte primeiro nossas FAQs ou fale com nossa equipe de suporte no Discord.

​
1. Faça login ou crie uma conta

Faça login em novita.ai. Você pode usar autenticação com Google ou GitHub, ou cadastre-se com seu endereço de e-mail.

​
2. Crie uma chave de API

O Novita AI autentica solicitações de API com uma chave de API Bearer. Abra Key Management para criar ou gerenciar uma chave e, em seguida, siga API Keys para armazená-la com segurança. Nestes exemplos, passe sua chave de API apenas por meio da variável de ambiente NOVITA_API_KEY. Não coloque uma chave de API real em código-fonte, documentação, conversas com agentes, análises, capturas de tela ou logs.

​
3. Confirme o crédito disponível

Verifique seu crédito disponível em Billing and Payments antes de enviar uma solicitação. O crédito do produto e o acesso ao modelo podem afetar se uma solicitação será bem-sucedida. Para uso de maior duração, consulte Automatic Top-up.

​
4. Envie sua primeira solicitação de LLM

Conclua as etapas de conta, chave de API e crédito acima antes de executar este exemplo. Ele usa o endpoint de chat completions compatível com OpenAI e o modelo deepseek/deepseek-v4.1-flash:
Uma solicitação bem-sucedida retorna HTTP 200 e um valor choices[0].message.content não vazio, como "Hello!". O texto exato pode variar conforme o modelo. Adicione --include ao comando cURL para inspecionar o status HTTP e também o corpo da resposta. Um HTTP 200 sozinho não confirma uma resposta de modelo válida. Se a solicitação falhar, use o guia correspondente:
  • 401 Unauthorized: verifique o formato da chave e a configuração da chave de API.
  • 403 Forbidden: o gateway do Novita pode retornar INVALID_API_KEY para uma chave ausente ou inválida; verifique a chave primeiro. Para um erro de acesso ao modelo, verifique o acesso ao modelo e se a verificação de identidade é necessária.
  • 429 Too Many Requests: verifique os limites de taxa.
  • 5xx: verifique os códigos de erro comuns e as orientações de nova tentativa.
Para Python, JavaScript, streaming e opções de solicitação adicionais, continue no guia da API de LLM.

​
5. Use seu agente

Seu agente pode ajudar você a criar a solicitação e integrar o Novita AI. Conclua as etapas de conta, chave de API e crédito acima e disponibilize NOVITA_API_KEY no ambiente em que o agente executa o código. Peça a ele para ler a skill do Novita AI:
Se o seu agente oferece suporte a skills, você pode instalá-la uma vez:
Ver a skill no GitHub →. Depois que o agente escrever a integração, execute a solicitação e verifique HTTP 200 com choices[0].message.content não vazio. Se o caminho do agente não funcionar, volte para a solicitação manual.

​
6. Solução de problemas

Se você não conseguir concluir a primeira solicitação, verifique estes itens na ordem:
  1. A variável de ambiente NOVITA_API_KEY está definida no shell atual.
  2. A chave está ativa e tem acesso a deepseek/deepseek-v4.1-flash.
  3. Sua conta tem crédito disponível e concluiu qualquer verificação necessária.
  4. O endpoint, o ID do modelo e o corpo da solicitação correspondem ao exemplo.
  5. O código de status retornado está coberto por Códigos de erro comuns.
Para obter uma lista completa de endpoints e parâmetros, consulte a Referência da API.
Última modificação em 17 de setembro de 2026