接口说明

本接口兼容 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 示例。
成功时返回 JSON,模型的回答在 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 上限,可按需调整。