Novita AI Aan de slag

Novita AI biedt je gehoste model-API’s, agent-sandboxes en GPU-infrastructuur. Volg het pad dat bij je taak past en verifieer een werkend resultaat voordat je verdergaat naar de diepgaandere gidsen.

Als je vragen hebt, bekijk dan eerst onze FAQs of neem contact op met ons supportteam op Discord.

1. Meld je aan of maak een account aan

Meld je aan bij novita.ai. Je kunt Google- of GitHub-authenticatie gebruiken, of registreer je met je e-mailadres.

2. Maak een API-sleutel aan

Novita AI authenticeert API-verzoeken met een Bearer-API-sleutel. Open Sleutelbeheer om een sleutel aan te maken of te beheren, en volg daarna API-sleutels om deze veilig op te slaan. Geef je API-sleutel in deze voorbeelden alleen door via de NOVITA_API_KEY omgevingsvariabele. Zet nooit een echte API-sleutel in broncode, documentatie, agentchats, analytics, screenshots of logs.

3. Controleer je beschikbare tegoed

Controleer je beschikbare tegoed op Facturering en betalingen voordat je een verzoek verstuurt. Producttegoed en modeltoegang kunnen van invloed zijn op of een verzoek slaagt. Voor langduriger gebruik, zie Automatisch opwaarderen.

4. Verstuur je eerste LLM-verzoek

Voltooi de stappen voor account, API-sleutel en tegoed hierboven voordat je dit voorbeeld uitvoert. Het gebruikt de OpenAI-compatibele chat-completions-endpoint en het deepseek/deepseek-v4.1-flash model:

export NOVITA_API_KEY="<Your API Key>"

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash",
    "messages": [
      {
        "role": "user",
        "content": "Say hello in one sentence."
      }
    ],
    "max_tokens": 64
  }'

Een succesvol verzoek retourneert HTTP 200 en een niet-lege choices[0].message.content waarde, zoals "Hello!". De exacte bewoording kan per model verschillen. Voeg --include toe aan het cURL-commando om zowel de HTTP-status als de responsbody te inspecteren. Alleen een HTTP 200 bevestigt geen geldige modelrespons. Als het verzoek mislukt, gebruik dan de bijbehorende gids:

401 Unauthorized: controleer het sleutelformaat en API-sleutelconfiguratie.
403 Forbidden: de Novita-gateway kan INVALID_API_KEY retourneren voor een ontbrekende of ongeldige sleutel; controleer eerst de sleutel. Controleer bij een modeltoegangsfout modeltoegang en of identiteitsverificatie vereist is.
429 Too Many Requests: controleer snelheidslimieten.
5xx: controleer veelvoorkomende foutcodes en richtlijnen voor opnieuw proberen.

Voor Python, JavaScript, streaming en aanvullende verzoekopties, ga verder naar de LLM-API-gids.

5. Gebruik je agent

Je agent kan je helpen het verzoek te maken en Novita AI te integreren. Voltooi de stappen voor account, API-sleutel en tegoed hierboven, en zorg dat NOVITA_API_KEY beschikbaar is in de omgeving waarin de agent de code uitvoert. Vraag de agent om de Novita AI-skill te lezen:

Read https://raw.githubusercontent.com/novitalabs/novita-skills/main/skills/novita-ai/SKILL.md and use Novita AI for this task.

Als je agent skills ondersteunt, kun je deze één keer installeren:

npx skills add novitalabs/novita-skills --skill novita-ai

Bekijk de skill op GitHub →. Nadat de agent de integratie heeft geschreven, voer je het verzoek uit en verifieer je HTTP 200 met een niet-lege choices[0].message.content. Als het agentpad niet werkt, ga dan terug naar het handmatige verzoek.

6. Probleemoplossing

Als je het eerste verzoek niet kunt voltooien, controleer dan het volgende in deze volgorde:

De NOVITA_API_KEY omgevingsvariabele is ingesteld in de huidige shell.
De sleutel is actief en heeft toegang tot deepseek/deepseek-v4.1-flash.
Je account heeft beschikbaar tegoed en heeft eventuele vereiste verificatie voltooid.
Het endpoint, de model-ID en de requestbody komen overeen met het voorbeeld.
De geretourneerde statuscode wordt behandeld in Veelvoorkomende foutcodes.

Zie voor een volledige lijst van endpoints en parameters de API-referentie.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Quickstart

1. Meld je aan of maak een account aan

2. Maak een API-sleutel aan

3. Controleer je beschikbare tegoed

4. Verstuur je eerste LLM-verzoek

5. Gebruik je agent

6. Probleemoplossing

​1. Meld je aan of maak een account aan

​2. Maak een API-sleutel aan

​3. Controleer je beschikbare tegoed

​4. Verstuur je eerste LLM-verzoek

​5. Gebruik je agent

​6. Probleemoplossing

1. Meld je aan of maak een account aan

2. Maak een API-sleutel aan

3. Controleer je beschikbare tegoed

4. Verstuur je eerste LLM-verzoek

5. Gebruik je agent

6. Probleemoplossing