CodexでAPIをYouTubeショート向けに解説

YouTube向けのCodex

API呼び出しを短い動画で見せれば、ドキュメントを読まない開発者にも機能を紹介できます。ただし、機能ごとに台本、画面録画、アップロードを用意する作業が必要です。ドキュメントにコード例があるなら、Codexはその例を読み、動作を確かめて、実際の出力に沿った口頭説明を作れます。ここではAPI企業の開発者向け広報担当者を例に、撮影前のテスト、下書きの作成、本人が担当する録画と最終承認までの流れを説明します。

例：決済APIで冪等性キーを説明する

決済企業のドキュメントに、冪等性キーによって二重請求を防ぐ10行のコード例があるとします。開発者向け広報の担当者は、Codexにその例を読み、テスト環境で実行するよう依頼します。Codexは2回目の呼び出しが同じ結果を返すことを確かめ、二重請求の問題、1行の対処、画面上の結果を説明する45秒の台本と、100文字未満のタイトルを3案作ります。担当者は端末画面を録画し、Tarenoのライブラリに追加します。Codexはlist_mediaで動画を探し、create_draftsで下書きを保存します。木曜14時、Europe/Dublinの予約依頼は、担当者が承認するまで保留されます。

手順

1. 01

   CodexをTarenoに接続する

   CodexのコマンドラインからTarenoをリモートMCPサーバーとして追加し、OAuthでログインします。手順はCodexの概要ページで確認できます。ChatGPTへの接続はCodexに引き継がれないため、別途設定してください。

2. 02

   コード例を指定する

   ドキュメントのファイルまたはコード断片を指定します。テスト環境で実行し、各呼び出しの出力を報告するようCodexに依頼してください。動かないコードを説明すると、視聴者の信頼を損なうおそれがあります。

3. 03

   画面の内容に沿って台本を書く

   端末の出力を順に追う約45秒の口頭用台本を依頼します。各文を実際の出力と照らし合わせ、画面に表示される内容とナレーションが一致するように確認してください。

4. 04

   本人がデモを録画する

   Codexはデモを録画できません。60秒以内の縦型動画を自分で撮影し、キーやアカウントIDが映っていないか確認してから、Tarenoのメディアライブラリに追加します。

5. 05

   下書きを保存する

   Codexはlist_mediaで動画を見つけ、create_draftsを使ってタイトルとファイルを対象チャンネルの下書きとして保存します。日時を依頼する前に、Tarenoで動画と台本を一緒に確認してください。

6. 06

   公開日時を依頼して承認する

   日付、時刻、IANAタイムゾーンを指定します。依頼は承認待ちのアクションとなり、本人がダッシュボードで承認します。Codexはその後get_action_statusで処理状況を確認できます。

コピーして使えるプロンプト

docs/idempotency.mdを読み、コードブロックの例をテスト環境で実行してください。各呼び出しの出力を正確に報告し、ドキュメントに書かれた動作と実際の結果に違いがあればすべて示してください。録画を始める前に実行結果を確認したいので、失敗した場合もその内容を報告してください。

この例の縦型画面録画に合わせた約45秒の口頭用台本を書いてください。二重請求の問題、1行の対処、画面に表示される結果を説明し、各文を端末出力の行に対応させてください。100文字以内のタイトルを3案提案し、画面と説明が食い違わないようにしてください。

Tarenoのメディアライブラリから[idempotency-demo.mp4]を探し、[チャンネル名]向けのYouTube下書きとしてタイトル案[2]と一緒に保存してください。動画が60秒を超える場合や縦型でない場合は知らせてください。私が動画と文章を確認するまで、予約は依頼しないでください。

Tarenoに下書き[下書きID]を[木曜14時]、[Europe/Dublin]のタイムゾーンで予約するよう依頼してください。承認待ちアクションのIDを返し、私がTarenoのダッシュボードで承認するまでショート動画は予約されないことを明記してください。確認用に日時と対象アカウントも示してください。

避けるべき間違い

• コード例を実行せずに撮影すること。画面上で呼び出しが失敗すると、信頼できるデモではなく不具合報告のように見えてしまいます。
• 端末の出力より速く説明すること。台本を実行時間に合わせ、映像とナレーションを一緒に確認してください。
• 本番用のキーをデモに使うこと。テストキーを使用して後で交換し、録画に映っていないか確認してください。
• 45秒に3つの機能を詰め込むこと。このショート動画には1つの呼び出し、1つの結果、状況説明の1文で十分です。