n8n 接入文本、图片与视频模型

更新于 ;软件与模型验证范围见正文。

本文每次执行处理一个输入任务,用 HTTP Request 节点分别连接三种接口,不依赖单一 AI 节点覆盖全部协议。官方节点字段已核验;本机未安装 n8n,工作流执行和界面版本尚未实测。对应文本和图片接口已真实调用。

n8n:三类请求分别读取结果
流程示意,非软件界面截图;完整请求字段见下方步骤。

第 1 步:创建专用凭据

进入 apizt 控制台 → API 令牌 → 新建,选择支持目标模型及协议的分组,设置额度后复制令牌。已有令牌可继续使用;模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。

新建 Header Auth 凭据:Name 为 Authorization,Value 为 Bearer YOUR_tokenba_API_KEY。HTTP Request 使用 Generic Credential Type → Header Auth,并选此凭据;不要在 JSON Body 里填写 Key。

第 2 步:运行文本节点

HTTP Request 字段设置
MethodPOST
URLhttps://api.apizt.com/v1/chat/completions
Send Body / Body Content Type开启 / JSON
Response FormatJSON
{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Reply exactly tokenba_OK"
    }
  ],
  "max_tokens": 32
}

Execute step 后检查 choices[0].message.content。如果开启 Include Response Headers and Status,正文位于 body,表达式改为 {{ $json.body.choices[0].message.content }}。

第 3 步:生成并下载图片

复制 HTTP Request 节点,将 URL 改为 https://api.apizt.com/v1/images/generations,Body 使用:

{
  "model": "gpt-image-2",
  "prompt": "A small friendly blue whale, no text.",
  "n": 1,
  "size": "1024x1024",
  "quality": "low"
}

读取 data[0],不是 choices。若有 url,新增 GET 节点,URL 表达式 {{ $json.data[0].url }},不选择网关凭据,Response Format=File、Put Output in Field=data。若返回 b64_json,先用 Edit Fields 将 {{ $json.data[0].b64_json }} 保存为 image_base64,再用 Convert to File → Move Base64 String to File,Base64 Input Field=image_base64,并按实际图片格式设置文件名和 MIME Type,再传给存储节点。参数名称按当前 n8n 版本核对。

第 4 步:提交视频任务并轮询

POST URL 为 https://api.apizt.com/api/v3/contents/generations/tasks:

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "A blue whale swimming slowly."
    }
  ],
  "duration": 5,
  "ratio": "16:9"
}
  1. 命名创建节点为 Create video,用 Edit Fields 保存 task_id,值为 {{ $json.id }}。
  2. 接 Wait,延迟 5 秒,再执行 GET;URL 使用 https://api.apizt.com/api/v3/contents/generations/tasks/{{ $('Create video').item.json.id }},关闭 Send Body。
  3. IF 检查 status;succeeded 进入下载,queued/running 返回 Wait,失败状态终止并记录 error。
  4. 增加轮询次数或截止时间条件,例如最多 120 次;达到上限保留任务 ID,供后续查询。
  5. 成功后读取 content.video_url;GET 下载节点不带网关凭据,Response Format=File。

结果与排错

文本和图片独立接口真实结果见 调用记录;完整视频状态流程见 Python 视频流程。执行记录分享前隐藏凭据,429 和请求重复问题见 重试与费用。

接口与官方资料

文本接口 · Images 参数 · 视频创建 · n8n 基础图文教程。

HTTP Request 官方字段 · Wait 官方说明。

开始实践:注册并创建 API Key · 已有账号,进入控制台 · 查看当前模型价格。

Convert to File 官方参数。