Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta
#2,235 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
58/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
node.js, typescript

Direzione di ricerca

Inizia confrontando 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 e js/src/vendor-sdk-types/openai.ts con la strumentazione esistente dei provider. Decidi come rappresentare il ciclo di vita di create, polling e download, quindi aggiungi la copertura in e2e/scenarios/openai-instrumentation/. Il lavoro è completato quando videos.create è strumentato con il ciclo di vita concordato e lo scenario e2e verifica gli spans risultanti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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
Lingua principale
TypeScript
Stelle
29
Fork
16
Merge medio
1g 20h
PR unite (30g)
70

Preparare l'ambiente

  • Include un Dockerfile o un file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di braintrustdata/braintrust-sdk-javascript

Tutte le issue di braintrustdata/braintrust-sdk-javascript

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.