OpenF1 APIで読み解くハミルトンの初回ピットストップ(2025年アブダビGP)

Piotr Grudzień
公開日 読了時間:約11分
赤いF1マシンのイラストと、ハミルトンの8周目のピットレーン滞在時間および静止時間

2025年アブダビGPの8周目、ルイス・ハミルトンはピットレーンに21.601秒滞在しました。フェラーリのマシンが静止していたのは2.4秒です。 どちらも同じピットストップの計測値です。タイミング表を見ると、この前後で最もタイムが長いのは、実は9周目です。

この流れは自分でも再現できます。OpenF1 APIを読み取るQuickchat AIのエージェント、Stint Notebookを作りましょう。ハミルトンの最初のピットストップとその前後3周について聞くと、7周分のラップタイム、ソフトからハードへの交換、回答の根拠となるレコードへのリンクが返ってきます。

OpenF1が記録した8周目のピットレーン滞在時間と静止時間、その下にハミルトンの7周分を示すQuickchat AIの回答 このローカル環境での実行では、Quickchat AIが7周分のデータと、ピットストップ、タイヤスティント、各周の公開記録へのリンクを返しました。

Stint Notebookキットをダウンロードすると、5つのアクションの設定例、Main Prompt、保存済みのOpenF1レスポンス、そのまま実行できる短いPythonスクリプトが手に入ります。OpenF1の記録は、OpenF1のアカウントやAPIトークンがなくても確認できます。ステップ2でQuickchat AIにログインします。

1. アブダビGPのどのセッションを見る?

まず、レースとドライバーを特定します。グランプリの週末には複数のセッションがあり、ハミルトンはどのセッションでも44番です。周回番号が何を指すかは、セッションとドライバーの両方を特定して初めて決まります。

  1. OpenF1のセッションレコードを開きます。Race、Yas Marina Circuit、日付の2025年12月7日を確認します。すべてのリクエストにsession_key=9839を含めます。
  2. 44番のドライバーレコードを開くと、ルイス・ハミルトンとFerrariが返ります。アクションを追加する間、このタブは開いたままにしておきましょう。

OpenF1の決勝セッション9839とハミルトンのドライバー番号44で、ピット、スティント、ラップのレコードを結び付ける レースは固定します。ドライバー番号だけを変えれば、同じレースを走った別のマシンについても同じ質問ができます。

OpenF1のトップページにあるサンプルを試してみましょう。Shell を選んで Run をクリックすると、ハミルトンの最初の3周のデータが返ります。JSONのレスポンスから driver_number と lap_number を探してください。

OpenF1のShellサンプル、Runボタン、返された車番44のラップデータ このサンプルで取得するのは1〜3周目のデータです。後でピットストップについて質問するときは、5〜11周目のデータを指定します。

OpenF1は2023年以降の過去データを個人利用向けに提供しています。ライブデータへのアクセス方法は認証ガイドで確認できます。

2. エージェントに最初の2つのアクションを追加するには?

  1. Quickchat AIのアカウントを作成するか、ログインします。Add new AI Agent → Set up manuallyを選び、名前をStint Notebookにします。AIの応答やテストにはクレジットが必要です。
  2. Identity → Main Promptを開き、以下の指示を貼り付けて保存します。周回について説明する前に、どのデータを集めるべきかをエージェントに伝える指示です。
  3. Actions & MCPs → Custom Actions → Add Action → API Action → Create manuallyの順に進みます。API Action Nameにidentify_sessionを入力します。What to ask the user firstは空欄にします。API EndpointでGETを選び、以下のURLを入力します。HeadersとBodyは空欄にします。
  4. API Action Descriptionに以下の説明を入力し、アクションを保存して有効にします。identify_driverも同じ手順で作成します。こちらはWhat to ask the user firstにdriver_numberを追加し、Numberを選んで必須に設定します。続いて、Add AI Data → ParametersからそのパラメーターをURLに挿入します。

レースを固定した照会とGETエンドポイントを設定したQuickchat AIのAPI Actionエディター 保存したURLに、対象のレースが指定されています。会話から値を受け取る最初のアクションは、ドライバーの照会です。

Stint NotebookのMain Promptをコピー
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.
セッションとドライバーのアクション設定をコピー
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.

AI Previewを開き、次のように質問します。Which session is this, and is driver 44 in it? 次へ進む前に、レースの日付とハミルトンの名前が表示されることを確かめます。初めてアクションを設定する場合は、APIを呼び出すエージェントの作成ガイドでエディターの操作を確認できます。

3. 対象の7周をどう絞り込む?

ピットの記録を起点に対象区間を決めます。 このレースでハミルトンは8周目と31周目の2回、ピットストップを行いました。最初のストップを選び、その前後3周ずつを取得します。対象は5周目から11周目までで、両端を含みます。先にラップデータを求めると、エージェントはどの周を見ればよいか推測することになります。

F1公式の8周目のピットストップ集計と、ピットレーン滞在時間21.601秒、静止時間2.4秒を示すOpenF1のフィールド F1公式のピットストップ集計には21.601秒とあります。OpenF1にはピットレーン滞在時間の合計に加え、そのうちマシンが静止していた2.4秒も記録されています。

  1. Custom Actionsでget_driver_pitsとget_driver_stintsを追加します。どちらもドライバー照会と同じdriver_numberを必須パラメーターにします。ピットストップには単数形のエンドポイントpit、タイヤスティントの区間にはstintsを使います。OpenF1のフィールドリファレンスには、ピットレーン滞在時間の旧フィールド名pit_durationを含め、計測時間に関するフィールドの定義が載っています。
  2. get_driver_lapsを追加し、3つのパラメーターをすべて必須のNumberに設定します。Add AI Dataを使ってdriver_number、first_lap、last_lapをURLに挿入します。設定例の比較記号はエンコードされたまま使います。これで、周回番号 ≥ 開始周かつ周回番号 ≤ 終了周という条件になります。
  3. Test Responseに44、5、11を入力します。返された配列の先頭と末尾を確認し、3つのアクションを保存してすべて有効にします。このアクションが1回の質問で扱う範囲は10周以内にします。この上限はプロンプトで指定しており、APIのURL自体はより広い範囲も受け付けます。

ドライバー番号、開始周、終了周のパラメーターを設定したQuickchat AIのラップ取得アクション 開始周と終了周は同じGETリクエストに入れます。片方を省くと、レースの残りの周回まで取得することがあります。

ピット、スティント、ラップのアクション設定をコピー
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. 8周目と9周目で何が変わった?

AI Previewで次のメッセージを送ります。Show Hamilton's three laps before and after his first pit stop in the 2025 Abu Dhabi race. 回答はピットストップの記録を起点に、前後の周回へと読み進めましょう。OpenF1では8周目がソフトのスティントの最終周です。9周目はハードで走った最初の周で、この区間では唯一、is_pit_out_lapがtrueになっています。

ハミルトンの全58周のタイヤ内訳。1–8周目はソフト、9–31周目はハード、32–58周目はミディアム 対象の周がどのスティントの開始周と終了周の間に入るかを見れば、コンパウンドが分かります。8周目はまだ最初のスティントに含まれます。

周回番号ラップタイム(秒)タイヤコンパウンドピットの記録
590.229ソフト
690.254ソフト
790.539ソフト
892.249ソフトピットイン
9108.500ハードピットアウト
1088.517ハード
1189.022ハード

この区間で最も長い108.500秒の周には、ピットを出てコースに戻るまでの走行が含まれます。その次の、コースを丸1周した最初のラップは88.517秒でした。同じコンパウンドでの通常の周回としてこの2行を比較すると、片方がアウトラップだったという違いが見えなくなります。数値は7周分のラップレコードで一つずつ確認でき、タイヤはスティントの区間と照合できます。

ハミルトンの5周目から11周目までのラップタイム。108.500秒のアウトラップに印を付けている ピットストップの記録とラップタイムが最も長い周は、隣り合う行にあります。アウトラップのフラグを見れば、ペースの比較からどの周を外すべきか分かります。

実際に計算してみましょう。 キットを展開し、そのディレクトリでpython3 worksheet.pyを実行します。集計に含めた周と除外した周がすべて表示されます。ピットインした周、アウトラップ、ラップタイムが欠けている周を除くと、対象は5周で、中央値は90.229秒です。この値は、2種類のコンパウンドにまたがる対象周回の結果です。どちらか一方のスティントのペースを調べるなら、そのスティント内で区間を選び、除外した周を明示します。

5. AIによるレースの解説をどう検証する?

  1. Inboxで会話を開き、呼び出されたアクションを展開して、ラップ取得アクションのView logsを開きます。今回の実行では、5件のデータ取得がすべてHTTP 200を返しました。ラップ取得のリクエストにあるセッション9839、ドライバー番号44、開始周5と終了周11を、返された7行と照合します。
  2. 次のように質問します。Did Hamilton pit because Ferrari wanted an undercut? Stint Notebookは2回のピットストップの記録を取得し、その記録だけではフェラーリの判断理由を特定できないと説明しました。静止時間は元のピットレコードのstop_durationで確認できます。
  3. Testing → Simulationを開き、Create Dataset、Paste messagesの順に選んで、キットに入っているテスト用の質問を貼り付けます。質問と質問の間には、---だけを書いた行を入れます。データセットを保存し、Runを選びます。登録されていないドライバー番号を指定する質問と、ライブ更新を求める質問も含めます。今回、ドライバー番号999を照会すると、データ提供元から404が返りました。照会先にレコードがなければ、有効なドライバー番号を尋ねます。OpenF1でタイムが欠けている場合や一時的なエラーが返った場合は、その値を取得できないものとして扱います。

Quickchat AIのラップ取得ログに表示されたドライバー番号、開始周と終了周、返されたレスポンス 呼び出しログを見れば、実際のリクエストを、回答が説明しているピットストップと照合できます。

レースとタイミングデータで分かる範囲を確かめるStint Notebookの質問を使ったQuickchat AIのテスト画面 アクションの説明を変更したら、同じ質問を使います。回答と、アクションが取得したデータの両方を確認しましょう。

ピットストップの記録をもとにアンダーカットの質問に答え、タイミングデータで判断できる範囲を説明するQuickchat AI ピットストップの記録から、フェラーリがハミルトンをいつピットに呼んだかが分かります。タイミングデータにはチームの意図を示すフィールドがありません。

試しておきたい設定変更。 ラップの照会だけがHTTP 429を返し、残り4件は成功する状況をシミュレーションしました。エージェントはラップ取得のリクエストを2回試みました。ラップ取得アクションの説明に、リクエスト数の上限に達したら再試行しないよう指示を加え、同じ質問をもう一度実行しました。今度の試行は1回で、確認できたピットストップを報告し、ラップタイムは取得できなかったと伝えました。自分で指示文を調整してテストするときは、View logsで試行回数を確認できます。

すでにChatGPTやClaudeからQuickchat AIを管理しているなら、そのアシスタントにキットのactions.jsonとmain-prompt.txtを渡し、セッション9839用の5つのGETアクションを準備するよう頼めます。有効にする前に各URLを確認してください。テストを実行するとQuickchat AIのクレジットを消費します。

Stint Notebookで2回目のピットストップも追ってみましょう。 ハミルトンの次のタイヤ交換について質問します。今度はピットストップの記録が31周目を示し、ミディアムのスティントの最初の周は32周目になるはずです。解説を読む前に、この2つの記録で回答を確認できます。

よくある質問

F1のタイヤスティントとは?

タイヤスティントとは、ドライバーが同じタイヤセットで走る一連の周回です。OpenF1では、各スティントに番号、コンパウンド、開始周、終了周が記録されています。2025年アブダビGPでハミルトンは、最初のスティントをソフトタイヤで1周目から8周目まで走りました。

OpenF1の過去データを取得するにはAPIキーが必要ですか?

いいえ。OpenF1では、2023年以降のセッションの過去データを、個人利用であればAPIキーなしで取得できます。Quickchat AIでの会話やテストにはクレジットを使います。ライブデータには別の利用条件があります。

2025年アブダビGPで、ハミルトンの最初のピットストップには何秒かかりましたか?

OpenF1によると、8周目のピットレーン滞在時間は21.601秒、マシンの静止時間は2.4秒でした。pitエンドポイントでは、それぞれlane_durationとstop_durationというフィールドで返されます。静止時間はピットレーン滞在時間に含まれています。

OpenF1 APIでF1のラップタイムとタイヤコンパウンドを取得するには?

同じsession_keyとdriver_numberでlapsとstintsを取得します。各lap_numberについて、その周がlap_startからlap_endまでの範囲に入るスティントのコンパウンドを使います。lapsエンドポイントのlap_durationは秒単位です。

この周回データから、フェラーリがハミルトンをピットに呼んだ理由は分かりますか?

記録から分かるのは、ハミルトンがいつピットに入り、何秒間静止し、その後どのタイヤを履いたかです。チームの判断理由は記録されていません。アンダーカットなどの戦略だったと判断するには、ライバルの動きとチームの意図を裏付ける情報が必要です。

この7周からスティントのペースを推定できますか?

集計に含めた周を明示すれば、この区間のペースを説明できます。付属のPythonスクリプトは、ピットインした周、アウトラップ、ラップタイムが欠けている周を除外し、対象の周回数と中央値を表示します。2種類のコンパウンドにまたがる区間から、どちらかのスティントを代表するペースを求めることはできません。

Quickchat AI Quickchat AI Ask Quickchat AI a question