openai-python v2.2.0版本更新详解：新增Videos API与ChatKit测试功能

发布日期：2025-10-06 openai-python 在 v2.2.0 版本中带来了重要更新，不仅增加了视频生成与管理的 Videos API，还在 Beta 功能中引入了全新的 ChatKit 模块，支持会话、线程及文件上传等功能，进一步丰富了开发者可用的接口能力。

一、版本升级信息

• • 版本号：由 2.1.0 升级至 2.2.0
• • 新增功能：
  • • api: dev day 2025 launches
  • • 新增 Videos API，支持视频生成、管理、下载与 Remix
  • • Beta 功能新增 ChatKit 模块
• • Bug 修复：
  • • client: add chatkit to beta resource
  • • 修复并重新加入 realtime 和 chat 模块

二、核心更新点

1. 新增 Videos API

Videos API 是本次版本中的一大亮点，支持从创建到下载、删除以及视频 Remix 的全流程操作。

涉及类型（Types）： .

from openai.types import (
    Video,
    VideoCreateError,
    VideoModel,
    VideoSeconds,
    VideoSize,
    VideoDeleteResponse,
)

主要方法（Methods）：

• • 创建视频 client.videos.create(**params) -> Video
• • 获取视频信息 client.videos.retrieve(video_id) -> Video
• • 列出视频 client.videos.list(**params) -> SyncConversationCursorPage[Video]
• • 删除视频 client.videos.delete(video_id) -> VideoDeleteResponse
• • 下载视频内容 client.videos.download_content(video_id, **params) -> HttpxBinaryResponseContent
• • 视频 Remix client.videos.remix(video_id, **params) -> Video
• • 创建并自动轮询任务结果 client.videos.create_and_poll(*args) -> Video

示例：创建并轮询视频生成任务 .

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI()

async def main() -> None:
    video = await client.videos.create_and_poll(
        model="sora-2",
        prompt="A video of the words 'Thank you' in sparkling letters",
    )

    if video.status == "completed":
        print("Video successfully completed: ", video)
    else:
        print("Video creation failed. Status: ", video.status)

asyncio.run(main())

2. Beta 功能新增 ChatKit 模块

ChatKit 功能结构：

• • Sessions：会话管理，支持创建、取消
• • Threads：线程管理（详细内容在 threads.py 中）
• • 文件上传：支持 PDF、PNG、JPG、JPEG、GIF、WEBP 等格式

上传文件示例（同步方式）： .

chatkit.upload_file(file="example.pdf")

Sessions API：

• 创建会话： .

sessions.create(
    user="user123",
    workflow=workflow_param,
    chatkit_configuration=chatkit_config_param,
    expires_after=expires_param,
    rate_limits=rate_limits_param
)

• 取消会话： .

sessions.cancel(session_id="session_abc123")

所有请求均需带有： .

extra_headers = {"OpenAI-Beta": "chatkit_beta=v1"}

3. 资源注册更新

• • 在 openai/_client.py、openai/_module_client.py 等地方引入新的 videos 资源
• • 在 openai/resources/__init__.py 注册 Videos 相关类
• • 在 openai/resources/beta/__init__.py 注册 ChatKit 相关类及各种响应包装（RawResponse / StreamingResponse）

三、变更文件概览

• • 新增文件：
  • • examples/video.py（视频创建用例）
  • • src/openai/resources/videos.py（视频资源实现）
  • • src/openai/resources/beta/chatkit/*（ChatKit 会话、线程与文件上传实现）
• • 更新文件：
  • • .release-please-manifest.json
  • • .stats.yml
  • • api.md、helpers.md（接口文档及帮助方法）
  • • pyproject.toml、_version.py（版本号更新）
  • • 多个资源注册文件增加 videos/chatkit 引用

四、总结

openai-python v2.2.0 在功能上有两项重大扩展：

1. 1. Videos API：让开发者可以直接生成、管理、下载视频，支持流式与轮询模式，极大拓展了多媒体生成的场景。
2. 2. ChatKit（Beta）：提供会话与线程管理能力，并允许上传文件到会话中，为构建复杂的聊天增强应用提供了基础。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。