Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[bot] OpenAI Videos API (`videos.create()` / Sora) not instrumented

オープン
  • 何か問題がありますか？
#2,235 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
58/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
node.js, typescript
領域
observability-sre

調査の方向性

まず、js/src/wrappers/oai.ts、js/src/auto-instrumentations/configs/openai.ts、js/src/instrumentation/plugins/openai-channels.ts、js/src/instrumentation/plugins/openai-plugin.ts、js/src/vendor-sdk-types/openai.ts を既存の provider instrumentation と比較します。create、polling、download のライフサイクルをどのように表現するかを決定し、その後 e2e/scenarios/openai-instrumentation/ にカバレッジを追加します。videos.create が合意したライフサイクルで instrumented になり、e2e シナリオが結果として生成される spans を検証すれば完了です。

索引モデルが issue の本文から書いたものです。

説明

Summary

The OpenAI Node SDK (openai npm package, >=6.2.0) exposes a GA client.videos.create() API for text-to-video and image-to-video generation using the Sora 2 / Sora 2 Pro models. This is a distinct generative execution surface — separate from chat completions, the Responses API, and images.generate() — and is completely uninstrumented in this repo. Users generating video with Sora through the JS SDK get no Braintrust spans.

This repo already treats the analogous gaps for other providers/modalities as in-scope and trackable:

  • OpenAI images.generate() / images.edit() — open gap braintrustdata/braintrust-sdk-javascript#1628
  • Google GenAI models.generateVideos() (Veo) — open gaps braintrustdata/braintrust-sdk-javascript#2030 / braintrustdata/braintrust-sdk-javascript#2176

The OpenAI videos.* resource is the same category of gap (a dedicated generative media API, distinct from the text/chat path) but for OpenAI specifically, and it is not covered by any of those issues or any other open issue in this repo.

What instrumentation is missing

  • Wrapper (js/src/wrappers/oai.ts): No proxy for the videos resource. Only chat.completions, embeddings, moderations, and responses are wrapped (confirmed by reading the file — no video references at all).
  • Auto-instrumentation config (js/src/auto-instrumentations/configs/openai.ts): No config entry for videos.create (or videos.remix/videos.retrieve). The file only instruments chat.completions.create, embeddings.create, chat.completions.parse, moderations.create, chat.completions.stream, and the responses.* family.
  • Channels (js/src/instrumentation/plugins/openai-channels.ts): No channel definitions for video generation (confirmed — no video references).
  • Plugin (js/src/instrumentation/plugins/openai-plugin.ts): No handler for video generation calls.
  • Vendor types (js/src/vendor-sdk-types/openai.ts): No Videos/VideoCreateParams types.
  • e2e: No test scenario under e2e/scenarios/openai-instrumentation/ exercises video generation.

Upstream reference

  • OpenAI Videos API reference: https://developers.openai.com/api/reference/resources/videos/methods/create
  • Video generation guide: https://developers.openai.com/api/docs/guides/video-generation
  • client.videos.create({ model, prompt, size, seconds, input_reference }) — model accepts sora-2 / sora-2-pro; returns a video job object (object: "video", with id, status, created_at, model) that is polled via videos.retrieve(id) until the render completes, then downloaded via videos.downloadContent(id).
  • This is a stable, GA, production API available in openai Node SDK >=6.2.0 — well within this repo's already-supported openai version range (>=4.0.0, and the repo's own dev-pin is [email protected], which already includes this resource).
  • Similar to models.generateVideos() in Google GenAI, this uses a long-running-operation/polling pattern rather than a single synchronous response — instrumentation will likely need to decide whether to span just the initial create() call or track the full poll-to-completion lifecycle (the existing google-genai-generate-videos issues note the same design question).

Braintrust docs status

not_found — Fetched https://www.braintrust.dev/docs/integrations/ai-providers/openai directly: it documents chat completions, embeddings (via gateway), audio transcriptions, images, structured outputs, and function calling as traced via wrapOpenAI, but does not mention videos.create, Sora, or any video generation capability anywhere.

Local repo files inspected

  • js/src/wrappers/oai.ts — no video references
  • js/src/auto-instrumentations/configs/openai.ts — full method list confirmed (chat completions, embeddings, parse, moderations, stream, responses create/stream/parse/compact); no videos entry
  • js/src/instrumentation/plugins/openai-channels.ts — no video references
  • js/src/vendor-sdk-types/openai.ts — no video/Video references
  • e2e/scenarios/openai-instrumentation/ — no video generation scenario
  • Full repo grep for video/Video under js/src/ — only unrelated matches in attachment-utils.ts, google-genai.ts vendor types, and strands-agent-sdk files; none reference OpenAI's videos resource
主要言語
TypeScript
スター
29
フォーク
16
平均マージ
1日 20時間
マージ済み PR（30日）
70

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

braintrustdata/braintrust-sdk-javascript のほかの issue

braintrustdata/braintrust-sdk-javascript の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。