Reconstrueer Hamiltons pitstop in Abu Dhabi met de OpenF1-API

Piotr Grudzień
Gepubliceerd 9 min leestijd
Illustratie van een rode Formule 1-auto naast Hamiltons pitstraattijd en stilstandtijd in ronde 8

Lewis Hamilton bracht in ronde 8 van de Grand Prix van Abu Dhabi in 2025 21,601 seconden door in de pitstraat. Zijn Ferrari stond 2,4 seconden stil. Beide tijden horen bij dezelfde pitstop. Op de tijdstaat is ronde 9 de langste ronde in dat deel van zijn race.

Je kunt die reeks zelf reconstrueren. Je bouwt Stint Notebook, een agent in Quickchat AI die gegevens uit de OpenF1-API ophaalt. Vraag naar de drie ronden vóór en de drie ronden na Hamiltons eerste pitstop. Je krijgt zeven rondetijden, de wissel van zachte naar harde banden en links naar de brongegevens.

Onder de twee OpenF1-tijden voor de pitstop in ronde 8 staat het antwoord van Quickchat AI over zeven ronden van Hamilton Bij deze lokale test gaf Quickchat AI de gegevens van zeven ronden terug, met links naar de openbare gegevens over pitstops, bandenstints en afzonderlijke ronden.

Download de Stint Notebook-kit met de instellingen voor vijf acties, de Main Prompt, opgeslagen OpenF1-responsen en een klein uitvoerbaar Python-script. Je kunt de gegevens van OpenF1 bekijken zonder OpenF1-account of API-token. In stap 2 log je in bij Quickchat AI.

1. Welke sessie in Abu Dhabi bekijk je?

Begin met de race en de coureur. Een Grand Prix-weekend telt meerdere sessies en Hamilton rijdt in elke sessie met nummer 44. Een rondenummer krijgt pas betekenis als zowel de sessie als de coureur vastligt.

  1. Open de sessiegegevens in OpenF1. Zoek naar Race, Yas Marina Circuit en de datum 7 december 2025. Neem session_key=9839 op in elk verzoek.
  2. Open de coureursgegevens voor nummer 44. Daar vind je Lewis Hamilton en Ferrari. Laat dat tabblad open terwijl je de acties toevoegt.

OpenF1-racesessie 9839 en Hamiltons coureursnummer 44 koppelen de gegevens over pitstops, stints en ronden Houd de race vast. Als je alleen het coureursnummer wijzigt, kun je dezelfde vraag stellen over een andere auto in die race.

Probeer het voorbeeld op de homepage van OpenF1. Kies Shell en klik op Run. Het voorbeeld haalt Hamiltons eerste drie ronden op. Zoek driver_number en lap_number in het JSON-antwoord.

Het Shell-voorbeeld van OpenF1, de knop Run en de opgehaalde rondegegevens van de coureur met startnummer 44 Dit voorbeeld haalt ronde 1 tot en met 3 op. De vraag over de pitstop gaat straks over ronde 5 tot en met 11.

OpenF1 biedt historische gegevens vanaf 2023 voor persoonlijk gebruik. In de handleiding voor authenticatie staat hoe je toegang krijgt tot livegegevens.

2. Hoe voeg je de eerste twee acties toe aan je agent?

  1. Maak een Quickchat AI-account aan of log in. Kies Add new AI Agent → Set up manually en geef je agent de naam Stint Notebook. Voor AI-antwoorden en tests heb je credits nodig.
  2. Open Identity → Main Prompt, plak de instructies hieronder en sla ze op. Zo weet de agent welke gegevens hij moet ophalen voordat hij een ronde toelicht.
  3. Ga naar Actions & MCPs → Custom Actions → Add Action → API Action → Create manually. Vul bij API Action Name identify_session in. Laat What to ask the user first leeg. Kies bij API Endpoint voor GET en vul de URL hieronder in. Laat Headers en Body leeg.
  4. Vul bij API Action Description de beschrijving hieronder in. Sla de actie op en schakel die in. Herhaal dit voor identify_driver. Voeg voor die actie driver_number toe onder What to ask the user first, kies Number, maak de parameter verplicht en voeg die via Add AI Data → Parameters toe aan de URL.

De API Action-editor van Quickchat AI met de vaste racesessie en het GET-endpoint De race ligt vast in de opgeslagen URL. De actie die de coureur opzoekt, is de eerste die een waarde uit het gesprek nodig heeft.

Kopieer de Main Prompt voor Stint Notebook
You are Stint Notebook. Help a race viewer inspect the completed 2025 Abu Dhabi Grand Prix, OpenF1 session 9839. Confirm the Race session and driver with Actions before reporting race facts. For Hamilton use driver 44 and verify his name. If a driver cannot be found, ask for a valid number. Run Actions one at a time. For a stop, fetch the driver's pit events and stints, then fetch at most ten laps around the selected stop. Three laps on either side means seven rows including the pit lap.
Start with the pit lap, lane_duration in seconds and stop_duration in seconds. Join each lap to its inclusive stint interval. For a lap window, show a compact Markdown table with Lap, Time (s), Tyre and Note. Use three decimal places for lap times. Note the recorded pit lap and the is_pit_out_lap flag; leave the other notes blank. Cite the exact OpenF1 pit, stint and bounded lap queries as short Markdown links.
Use only returned fields. Distinguish time in the pit lane from stationary time. A missing duration is unavailable. If a request fails, say which data you could not retrieve. Timing alone cannot establish team intent. For an aggregate, give the source rows and tell the reader to use the worksheet. Only answer historical questions on demand.
Kopieer de instellingen voor de sessie- en coureursacties
identify_session
GET https://api.openf1.org/v1/sessions?session_key=9839
Identify the configured session. Check that session_name is Race, then report its date, circuit and session key.

identify_driver
GET https://api.openf1.org/v1/drivers?session_key=9839&driver_number={{driver_number}}
Resolve the driver by number within this race. Use full_name and driver_number from the response. If no record is found, ask for a valid number.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.

Open AI Preview en stel de vraag Which session is this, and is driver 44 in it? Controleer de racedatum en Hamiltons naam voordat je verdergaat. Maak je voor het eerst een actie, dan helpt de handleiding voor het bouwen van een agent die een API aanroept je door de editor.

3. Hoe vind je de juiste zeven ronden?

Laat de pitstopgegevens het rondebereik bepalen. Hamilton stopte in deze race twee keer, in ronde 8 en in ronde 31. Kies de eerste stop en vraag vervolgens de drie ronden ervoor en de drie ronden erna op. Zo krijg je ronde 5 tot en met 11. Als je eerst om de ronden vraagt, moet de agent gokken waar hij moet zoeken.

Het pitstopoverzicht van Formula 1 voor ronde 8 naast de OpenF1-velden voor 21,601 seconden in de pitstraat en 2,4 seconden stilstand Het pitstopoverzicht van Formula 1 vermeldt 21,601 seconden. OpenF1 registreert zowel die totale pitstraattijd als de 2,4 seconden stilstand die daarin vallen.

  1. Voeg in Custom Actions get_driver_pits en get_driver_stints toe. Voor beide is dezelfde driver_number verplicht als bij het opzoeken van de coureur. Gebruik voor pitstops het enkelvoudige endpoint pit en voor bandenstints stints. De OpenF1-veldreferentie beschrijft de timingvelden, waaronder pit_duration, de oude naam voor de pitstraattijd.
  2. Voeg get_driver_laps toe met drie verplichte parameters van het type Number. Voeg driver_number, first_lap en last_lap via Add AI Data toe aan de URL. Neem de gecodeerde tekens uit het voorbeeld ongewijzigd over. De filters betekenen rondenummer ≥ eerste ronde en rondenummer ≤ laatste ronde.
  3. Vul in Test Response 44, 5 en 11 in. Controleer de eerste en laatste rij in het resultaat, sla de acties op en schakel ze alle drie in. Beperk deze actie tot tien ronden per vraag. Die limiet staat in de prompt. De API-URL zelf accepteert ook ruimere bereiken.

De actie voor rondetijden in Quickchat AI met parameters voor de coureur, de eerste ronde en de laatste ronde Beide grenzen horen in hetzelfde GET-verzoek. Als er één ontbreekt, kun je ook de rest van de race ophalen.

Kopieer de instellingen voor de acties voor pitstops, stints en rondetijden
get_driver_pits
GET https://api.openf1.org/v1/pit?session_key=9839&driver_number={{driver_number}}
Retrieve recorded pit events for the confirmed driver. Identify the requested pit lap. lane_duration is total time in the pit lane, stop_duration is stationary time; both are seconds. Preserve missing values.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.

get_driver_stints
GET https://api.openf1.org/v1/stints?session_key=9839&driver_number={{driver_number}}
Retrieve tyre compounds and inclusive lap_start and lap_end boundaries for this driver. Use these intervals to label the pit and surrounding laps.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.

get_driver_laps
GET https://api.openf1.org/v1/laps?session_key=9839&driver_number={{driver_number}}&lap_number%3E={{first_lap}}&lap_number%3C={{last_lap}}
Retrieve an inclusive interval of at most ten laps after selecting the pit event. Use lap_number, lap_duration in seconds and is_pit_out_lap. Preserve null durations. If OpenF1 returns HTTP 429, stop and ask the reader to try later. Do not repeat the lap request in the same turn.
driver_number (Number, required): Confirmed driver number in this session, such as 44 for Lewis Hamilton.
first_lap (Number, required): First lap number of the inclusive interval around the selected pit event.
last_lap (Number, required): Last lap number of the inclusive interval, at most nine above first_lap.

4. Wat veranderde er in ronde 8 en 9?

Stuur in AI Preview Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. Neem de pitstop als uitgangspunt bij het lezen van het antwoord. Ronde 8 is de laatste ronde die OpenF1 toewijst aan de stint op zachte banden. Ronde 9 is de eerste ronde op harde banden en de enige rij in dit bereik waarin is_pit_out_lap op true staat.

Hamiltons race van 58 ronden, met zachte banden in ronde 1–8, harde banden in ronde 9–31 en mediumbanden in ronde 32–58 Bepaal de bandencompound door te kijken tussen welke begin- en eindronde de ronde valt. Ronde 8 hoort nog bij de eerste stint.

RondenummerRondetijd (s)BandencompoundPitregistratie
590,229Zacht
690,254Zacht
790,539Zacht
892,249ZachtPitstraat in
9108,500HardPitstraat uit
1088,517Hard
1189,022Hard

De langste ronde in dit bereik, 108,500 seconden, omvat het uitrijden van de pitstraat en de terugkeer op de baan. De eerste volledige ronde daarna duurde 88,517 seconden. Als je beide tijden behandelt als gewone ronden op dezelfde compound, valt het uitrijden van de pitstraat buiten de vergelijking. Je kunt alle tijden nakijken in de zeven ronderegistraties en controleren bij welke bandenstints de ronden horen.

Hamiltons rondetijden van ronde 5 tot en met 11, met de uitrijronde van 108,500 seconden gemarkeerd De pitstop en de piek in de rondetijd staan op opeenvolgende rijen. De markering van de uitrijronde laat zien welke ronde je buiten de tempovergelijking laat.

Reken het zelf eens uit. Pak de kit uit en voer python3 worksheet.py uit in de uitgepakte map. Het script toont welke ronden meetellen en welke afvallen. Als je de ronde met de pitstop, de uitrijronde en eventuele ronden zonder rondetijd weglaat, blijven vijf ronden met een mediaan van 90,229 seconden over. Dat cijfer beschrijft de geselecteerde ronden op twee bandencompounds. Wil je het tempo van één stint onderzoeken, kies dan een reeks binnen die stint en vermeld welke ronden je weglaat.

5. Hoe controleer je een raceanalyse van AI?

  1. Open het gesprek in Inbox, klap de uitgevoerde acties uit en open bij de actie voor rondetijden View logs. Bij onze test gaven alle vijf verzoeken HTTP 200 terug. Controleer bij het rondetijdenverzoek of sessie 9839, coureur 44 en de grenzen 5 en 11 overeenkomen met de zeven teruggegeven rijen.
  2. Stel de vraag Did Hamilton pit because Ferrari wanted an undercut? Stint Notebook haalde beide pitstops op en legde uit dat Ferrari’s beweegredenen uit de gegevens niet zijn af te leiden. Controleer voor de stilstandtijd stop_duration in de oorspronkelijke pitstopregistratie.
  3. Open Testing → Simulation, kies Create Dataset en daarna Paste messages en plak de testvragen uit de kit. Zet tussen twee vragen telkens een regel met alleen ---. Sla de dataset op en kies Run. Neem ook een onbekende coureur en een verzoek om live-updates op. Voor coureur 999 gaf de API bij onze test 404 terug. Vraag om een geldig coureursnummer als de zoekactie geen gegevens vindt. Ontbreekt er een rondetijd of geeft OpenF1 een tijdelijke fout, laat die waarde dan als niet beschikbaar staan.

Het logboek van het rondetijdenverzoek in Quickchat AI toont de coureur, beide rondegrenzen en de API-respons In het logboek kun je het uitgevoerde verzoek vergelijken met de pitstop die in het antwoord wordt beschreven.

Tests in Quickchat AI met de Stint Notebook-vragen over de race en de grenzen van de timinggegevens Gebruik dezelfde vragen nadat je een actiebeschrijving hebt aangepast. Controleer zowel het antwoord als de gegevens die de actie heeft opgehaald.

Quickchat AI beantwoordt de vraag over de undercut met de geregistreerde pitstops en legt uit wat je uit de timinggegevens kunt afleiden De pitstops laten zien wanneer Ferrari Hamilton naar binnen haalde. De timingfeed bevat geen veld voor de bedoeling van het team.

Test wat er gebeurt als de API een limiet bereikt. We simuleerden HTTP 429 bij het ophalen van de rondetijden terwijl de andere vier verzoeken slaagden. De agent probeerde het rondetijdenverzoek twee keer. We voegden aan de beschrijving van die actie de instructie toe om te stoppen zodra de verzoeklimiet was bereikt en stelden dezelfde vraag opnieuw. Deze keer deed de agent één poging, meldde hij de geverifieerde pitstop en gaf hij aan dat de rondetijden niet beschikbaar waren. Als je je eigen formulering test, kun je de pogingen tellen in View logs.

Als je Quickchat AI al beheert vanuit ChatGPT of Claude, kun je die assistent actions.json en main-prompt.txt uit de kit geven en vragen om de vijf GET-acties voor sessie 9839 klaar te zetten. Controleer de URL’s voordat je de acties inschakelt. Een test uitvoeren kost Quickchat AI-credits.

Bekijk ook de tweede pitstop met Stint Notebook. Vraag naar Hamiltons volgende bandenwissel. De pitstopgegevens moeten je nu naar ronde 31 leiden en de stint op mediumbanden moet beginnen in ronde 32. Daarmee heb je twee referentiepunten om het antwoord te controleren voordat je de uitleg leest.

Veelgestelde vragen

Wat is een bandenstint in de Formule 1?

Een bandenstint is een reeks ronden die een coureur op één set banden rijdt. OpenF1 geeft elke stint een nummer, een bandencompound en een eerste en laatste ronde. Hamiltons eerste stint in Abu Dhabi in 2025 loopt van ronde 1 tot en met 8, op zachte banden.

Heb ik een API-sleutel nodig voor historische OpenF1-data?

Nee. Voor persoonlijk gebruik biedt OpenF1 toegang zonder API-sleutel tot historische sessiedata vanaf 2023. Quickchat AI gebruikt credits voor gesprekken en tests. Voor toegang tot livegegevens gelden aparte voorwaarden.

Hoe lang duurde Hamiltons eerste pitstop in Abu Dhabi in 2025?

OpenF1 registreert in ronde 8 een pitstraattijd van 21,601 seconden en een stilstandtijd van 2,4 seconden. In het pit-endpoint heten die velden lane_duration en stop_duration. De stilstandtijd zit al in de totale pitstraattijd.

Hoe haal ik F1-rondetijden en bandencompounds op via de OpenF1-API?

Haal de gegevens van laps en stints op met dezelfde session_key en driver_number. Neem voor elk lap_number de bandencompound van de stint waarin die ronde tussen lap_start en lap_end valt, inclusief beide grenzen. Het laps-endpoint geeft lap_duration in seconden.

Kun je aan deze ronden zien waarom Ferrari Hamilton naar binnen haalde?

De gegevens laten zien wanneer Hamilton stopte, hoe lang hij stilstond en op welke banden hij daarna reed. De reden voor de teambeslissing staat er niet in. Om vast te stellen of het om een strategie als een undercut ging, heb je informatie nodig over een concurrent en over wat het team wilde bereiken.

Kan ik met deze zeven ronden het tempo van een stint inschatten?

Je kunt het tempo over deze reeks beschrijven als je aangeeft welke ronden je meetelt. Het Python-script sluit de ronde met de pitstop, uitrijronden en ronden zonder rondetijd uit en geeft het aantal overgebleven ronden en de mediaan. Uit een reeks met twee bandencompounds kun je voor geen van beide stints een representatief tempo afleiden.

Quickchat AI Quickchat AI Ask Quickchat AI a question