参数与厂商扩展

字段属于具体协议

参数名称、类型和层级应与所用接口一致。下列对照帮助迁移请求，具体参数仍需所选模型支持；采样范围、推理选项和媒体规格不能直接从一个模型套用到另一个模型。

metadata 与 SDK extra_body

metadata 是某些接口的请求体字段，含义由接口定义：Messages 的 metadata.user_id 用于用户标识，Responses 的 metadata 用于附加键值，视频接口的 metadata 可承载模型专用选项。字段同名不代表用途或结构相同。

extra_body 是 OpenAI Python SDK 的调用选项，用于把字段加入最终 JSON 请求体；它自身不会作为 JSON 中的 extra_body 字段发送。SDK 能发送一个字段，也仍需目标接口和模型接受该字段。字段已由 SDK 提供时优先使用命名参数，并避免在两处重复设置同一字段。

下面是 Responses 协议示例，展示 SDK 参数如何形成请求体。将 MODEL_ID 替换为支持 Responses 的账户可用模型。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KEDANG_API_KEY"],
    base_url="https://ai.kedang.net/v1",
)

response = client.responses.create(
    model="MODEL_ID",
    input="用一句话解释 API。",
    extra_body={"metadata": {"project": "demo"}},
)

{
  "model": "MODEL_ID",
  "input": "用一句话解释 API。",
  "metadata": {
    "project": "demo"
  }
}

视频厂商字段位置

大小写也属于参数值：480p 与 480P 按模型分别填写。同时传入多处时长或分辨率字段时应保持一致。最终音轨和尺寸以结果文件为准。

Seedance 2.0 多模态格式：平台接入文档使用顶层 content[]，文本写入 text，图片、视频与音频写入对应的 *_url.url，用 role 区分首尾帧与参考素材；duration、resolution、ratio、generate_audio 写在顶层。这组示例使用 Doubao-Seedance-2.0-fast，不要将全部字段移入 metadata。查看六种输入组合与参数 →

MiniMax-H3 请求参数与调用示例 →：使用 H3 的 content 格式和平台任务查询响应，避免混用其他视频模型的字段。

构造请求时的边界

• JSON 中的数字、布尔值和数组应保持原类型；例如 stream 使用布尔值，seconds 在对应视频协议中使用字符串。
• 文件上传使用接口要求的 multipart/form-data；让客户端设置 boundary。JSON 扩展参数不能代替文件字段。
• 未知参数、超范围值或错误嵌套应先按接口说明修正。将参数移入 metadata 不会自动获得兼容性。
• 响应字段也有协议差异：Chat Completions 读取 choices，Responses 读取 output，Gemini 读取 candidates；成功的语音响应可能直接是音频字节。