Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#2,235 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
58/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
node.js, typescript
Lĩnh vực
observability-sre

Hướng nghiên cứu

Bắt đầu bằng cách so sánh 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 và js/src/vendor-sdk-types/openai.ts với instrumentation của các provider hiện có. Quyết định cách biểu diễn vòng đời của create, polling và download, sau đó bổ sung coverage trong e2e/scenarios/openai-instrumentation/. Hoàn tất khi videos.create được instrument với vòng đời đã thống nhất và kịch bản e2e xác minh các spans thu được.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
TypeScript
Star
28
Fork
15
Merge trung bình
1 ngày 20 giờ
Pull request đã merge (30 ngày)
70

Chuẩn bị môi trường

  • Có Dockerfile hoặc tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của braintrustdata/braintrust-sdk-javascript

Tất cả issue của braintrustdata/braintrust-sdk-javascript

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.