F1 RAG API REFERENCE

NVIDIA NIM Key Configuration

Follow this tutorial to get your own NVIDIA API key and configure it in the application.

How to Get your Key

1. Go to the official NVIDIA NIM API Catalog.
2. Log in or register for a free Developer Account.
3. Select any Large Language Model, such as google/diffusiongemma-26b-a4b-it.
4. Click "Get API Key" or "Generate Key" to generate your unique credential.
5. Copy the generated key (it always starts with the prefix nvapi-).

How to Apply it

Paste your copied key into the NVIDIA NIM AI Settings card on the left sidebar of the Dashboard UI and click "Save API Key". The dashboard will automatically reload and use your credentials to generate F1 predictions and execute RAG chats.

Programmatic API Header

When querying the backend REST APIs directly via fetch or curl, you can supply your custom API key using the HTTP request header:

X-NVIDIA-API-Key: nvapi-your-key-here

Retrieves the current Driver standings and Constructor standings of the ongoing 2026 World Championship.

curl -X GET "https://f1.alkile.dev/api/f1/standings"

{
  "drivers": [
    {
      "position": "1",
      "points": "171",
      "wins": "2",
      "Driver": { "driverId": "antonelli", "code": "ANT", "givenName": "Andrea Kimi", "familyName": "Antonelli" },
      "Constructors": [{ "constructorId": "mercedes", "name": "Mercedes" }]
    }
  ],
  "constructors": [
    {
      "position": "1",
      "points": "302",
      "wins": "3",
      "Constructor": { "constructorId": "mercedes", "name": "Mercedes", "nationality": "German" }
    }
  ]
}

Retrieves the complete 2026 race calendar schedule including GP dates, city locations, tracks, and session start times.

curl -X GET "https://f1.alkile.dev/api/f1/schedule"

Retrieves the complete details and finishing results for all completed races of the 2026 season.

curl -X GET "https://f1.alkile.dev/api/f1/results"

Returns the latest F1 news scraped from Autosport and Motorsport.com RSS feeds.

curl -X GET "https://f1.alkile.dev/api/f1/news"

Returns next race win probabilities (weighted standing points, recent form, team strength), world championship win projections, and a RAG-infused AI report explaining the news and details.

Request Headers

curl -X GET "https://f1.alkile.dev/api/f1/predict" \
  -H "X-NVIDIA-API-Key: nvapi-your-key-here"

{
  "upcoming_race": { "raceName": "British Grand Prix", "date": "2026-07-05", "Circuit": { "circuitName": "Silverstone Circuit" } },
  "next_race_probabilities": [
    { "driver_name": "Andrea Kimi Antonelli", "team_name": "Mercedes", "probability": 23.2 }
  ],
  "drivers_championship_probabilities": [
    { "driver_name": "Andrea Kimi Antonelli", "probability": 21.6 }
  ],
  "ai_analysis": "## AI Prediction Report...\nSilverstone is a high speed track which suits..."
}

Streams real-time, context-grounded SSE responses for chatbot interactions.

Request Headers

Request Body

const response = await fetch("https://f1.alkile.dev/api/chat", {
  method: "POST",
  headers: { 
    "Content-Type": "application/json",
    "X-NVIDIA-API-Key": "nvapi-your-key-here"
  },
  body: JSON.stringify({ message: "Who won Monaco GP?", top_k: 3 })
});

const reader = response.body.getReader();
// Decode and parse the SSE chunks on the "content" data lines...

Launches a background thread task to sync live standings and schedules from Jolpica-F1 API, scrape news articles, and update vector store embeddings.

curl -X POST "https://f1.alkile.dev/api/ingest"

Uploads custom documents (`.txt` or `.md` format) to the server to instantly chunk, embed, and index into the RAG vector search.

Multipart Form Params