Playground ↗ Postman ↗ Dashboard ↗

Generate your first course in 60 seconds

Nuton turns any topic, document, or video into a structured course. This is the shortest path from “I have an API key” to “my user just learned something new.”

1. Verify your connection

Before anything else, confirm the API is reachable from your environment. The /health endpoint is unauthenticated.

curl https://api.nuton.app/v2/health

You should see { "status": "ok" }. Nothing else is needed here — no auth, no body.

2. Authenticate

Every other endpoint needs your API key passed as X-API-Key. Keep it server-side; never embed it in client code that ships to browsers or mobile apps.

Two environments

Your test key (sk-nuton-test-…) is capped at 5 courses and 50 queries per month — perfect for development. The production key (sk-nuton-production-…) bills per user. Don’t mix them across environments.

3. Generate your first course

One call. Two chapters. Synchronous mode blocks until the LLM is done — for production you’ll want ?mode=async with webhooks, but for this first contact sync is fine.

curl -X POST "https://api.nuton.app/v2/courses/generate?mode=sync" \
  -H "X-API-Key: $NUTON_KEY" \
  -H "X-External-User-Id: alice@example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Photosynthesis basics",
    "num_chapters": 2
  }'

The response is the complete course, with chapters, quiz questions, key concepts, and sources.

Where to go next

You just generated a course. Pick whichever path matches what you’re building.