OpenAI Chat API 参考

url string（必选）

视频文件的公网 URL 或 Base64 Data URL。输入本地视频文件请参见输入 Base64 编码的本地文件。

fps有两个功能：

• 输入视频文件时，控制抽帧频率，每 $$\frac{1}{fps}$$秒抽取一帧。

  适用于 Qwen-VL 与QVQ 模型。

• 告知模型相邻帧之间的时间间隔，帮助其更好地理解视频的时间动态。同时适用于输入视频文件与图像列表时。该功能同时支持视频文件和图像列表输入，适用于事件时间定位或分段内容摘要等场景。

  支持Qwen3.6、Qwen3.5、Qwen3-VL、Qwen2.5-VL、Qwen3.5-Omni与QVQ模型。

较大的fps适合高速运动的场景（如体育赛事、动作电影等），较小的fps适合长视频或内容偏静态的场景。

• 图像列表传入：{"video":["https://xx1.jpg",...,"https://xxn.jpg"]，"fps":2}

• 视频文件传入：{"video": "https://xx1.mp4"，"fps":2}

• 输入图像：

  • Qwen3.6、Qwen3.5、Qwen3-VL：默认值和最小值均为：65536

  • Qwen3.5-Omni：默认值和最小值均为：24576

  • qwen-vl-max、qwen-vl-max-latest、qwen-vl-max-0813、qwen-vl-plus、qwen-vl-plus-latest、qwen-vl-plus-0815、qwen-vl-plus-0710：默认值和最小值均为4096

  • 其他qwen-vl-plus模型、其他qwen-vl-max模型、Qwen2.5-VL开源系列及QVQ系列模型：默认值和最小值均为3136

• 输入视频文件或图像列表：

  • Qwen3.6、Qwen3.5、Qwen3.5-Omni、Qwen3-VL（包括商业版和开源版）、qwen-vl-max、qwen-vl-max-latest、qwen-vl-max-0813、qwen-vl-plus、qwen-vl-plus-latest、qwen-vl-plus-0815、qwen-vl-plus-0710：默认值为65536，最小值为4096

  • 其他qwen-vl-plus模型、其他qwen-vl-max模型、Qwen2.5-VL开源系列及QVQ系列模型：默认值为50176，最小值为3136

• 输入图像：{"type": "image_url","image_url": {"url":"https://xxxx.jpg"},"min_pixels": 65536}

• 输入视频文件时：{"type": "video_url","video_url": {"url":"https://xxxx.mp4"},"min_pixels": 65536}

• 输入图像列表时：{"type": "video","video": ["https://xx1.jpg",...,"https://xxn.jpg"],"min_pixels": 65536}

• 输入图像：

  max_pixels 的取值与是否开启vl_high_resolution_images参数有关。

  • 当vl_high_resolution_images为False时：

    • Qwen3.6、Qwen3.5、Qwen3-VL：默认值为2621440，最大值为：16777216

    • Qwen3.5-Omni：默认值为1310720，最大值为：16777216

    • qwen-vl-max、qwen-vl-max-latest、qwen-vl-max-0813、qwen-vl-plus、qwen-vl-plus-latest、qwen-vl-plus-0815、qwen-vl-plus-0710：默认值为1310720，最大值为：16777216

    • 其他qwen-vl-plus模型、其他qwen-vl-max模型、Qwen2.5-VL开源系列及QVQ系列模型：默认值为1003520 ，最大值为12845056

  • 当vl_high_resolution_images为True时：

    • Qwen3.6、Qwen3.5-Omni、Qwen3.5、Qwen3-VL、qwen-vl-max、qwen-vl-max-latest、qwen-vl-max-0813、qwen-vl-plus、qwen-vl-plus-latest、qwen-vl-plus-0815、qwen-vl-plus-0710：max_pixels无效，输入图像的最大像素固定为16777216

    • 其他qwen-vl-plus模型、其他qwen-vl-max模型、Qwen2.5-VL开源系列及QVQ系列模型：max_pixels无效，输入图像的最大像素固定为12845056

• 输入视频文件或图像列表：

  • Qwen3.6系列、Qwen3.5系列、Qwen3.5-Omni、Qwen3-VL闭源系列、qwen3-vl-235b-a22b-thinking、qwen3-vl-235b-a22b-instruct：默认值为655360，最大值为2048000

  • 其他Qwen3-VL开源模型、qwen-vl-max、qwen-vl-max-latest、qwen-vl-max-0813、qwen-vl-plus、qwen-vl-plus-latest、qwen-vl-plus-0815、qwen-vl-plus-0710：默认值655360，最大值为786432

  • 其他qwen-vl-plus模型、其他qwen-vl-max模型、Qwen2.5-VL开源系列及QVQ系列模型：默认值为501760，最大值为602112

• 输入图像：{"type": "image_url","image_url": {"url":"https://xxxx.jpg"},"max_pixels": 8388608}

• 输入视频文件时：{"type": "video_url","video_url": {"url":"https://xxxx.mp4"},"max_pixels": 655360}

• 输入图像列表时：{"type": "video","video": ["https://xx1.jpg",...,"https://xxn.jpg"],"max_pixels": 655360}

• Qwen3.6系列、Qwen3.5系列：默认值和最大值均为819200000，该值对应 800000 个图像 Token（每 32×32 像素对应 1 个图像 Token）。

• Qwen3-VL闭源系列、qwen3-vl-235b-a22b-thinking、qwen3-vl-235b-a22b-instruct：默认值和最大值均为134217728，该值对应 131072 个图像 Token（每 32×32 像素对应 1 个图像 Token）。

• Qwen3.5-Omni：默认值和最小值均为184549376，该值对应 180224 个图像 Token（每 32×32 像素对应 1 个图像 Token）。

• 其他Qwen3-VL开源模型、qwen-vl-max、qwen-vl-max-latest、qwen-vl-max-0813、qwen-vl-plus、qwen-vl-plus-latest、qwen-vl-plus-0815、qwen-vl-plus-0710：默认值和最小值均为67108864，该值对应 65536 个图像 Token（每 32×32 像素对应 1 个图像 Token）。

• 其他qwen-vl-plus模型、其他qwen-vl-max模型、Qwen2.5-VL开源系列及QVQ系列模型：默认值和最小值均为51380224，该值对应 65536 个图像 Token（每 28×28 像素对应 1 个图像 Token）。

• 输入视频文件时：{"type": "video_url","video_url": {"url":"https://xxxx.mp4"},"total_pixels": 134217728}

• 输入图像列表时：{"type": "video","video": ["https://xx1.jpg",...,"https://xxn.jpg"],"total_pixels": 134217728}

type string（必选）

仅支持设定为ephemeral。