接口说明
本接口兼容 OpenAI Chat Completions 协议,可以直接使用 OpenAI 官方 SDK 调用。除文本对话外,具备相应能力的模型也支持多模态输入,例如 Gemini 的视频与音轨理解。请求地址
使用 SDK 时只填 Base URL,SDK 会自动拼接
/chat/completions;不要把完整请求地址填进 Base URL。
鉴权
在请求头中携带 API Key:Authorization: Bearer <你的 API Key>。API Key 在 API Key 页面 获取。
示例从环境变量 NONELINEAR_API_KEY 读取 API Key,运行前先在终端设置:
示例代码 (OpenAI SDK)
先安装 SDK:pip install --upgrade openai
cURL 调用示例
以下命令适用于 macOS / Linux 终端。Windows 用户可在 Git Bash 或 WSL 中运行,或使用 Python 示例。choices[0].message.content 中,本次消耗的 token 数在 usage 中。错误码说明见错误处理。
如果使用 GPT-5.4 系列模型时遇到
usage 有 token 消耗但 message.content 为空,请参考 错误处理:GPT-5.4 空输出。Gemini 视频与音轨理解
使用gemini-4-argon 等gemini系列模型,可以分析视频画面的变化和视频中的音轨。请求发送至 POST /v1/chat/completions,将完整 MP4 文件编码为 Base64,放入 messages[].content[] 中的 image_url.url,格式为 data:video/mp4;base64,...。音轨随视频文件一起传入,无需单独提取上传。
这里的内容类型
type 和字段名都使用 image_url,不要写成 video_url。虽然字段名包含 image,传入的视频仍应使用 video/mp4 MIME 类型。Python 示例
先安装 SDK(pip install --upgrade openai),设置上文的 NONELINEAR_API_KEY 环境变量,并将 video.mp4 替换为你的本地视频文件路径。
JSON 请求体
直接发送 HTTP 请求时,使用以下 JSON 结构,并将<此处为 Base64 数据> 替换为视频文件的实际 Base64 编码。max_tokens: 2048 是本示例设置的输出 token 上限,可按需调整。
