Crazyrouter API Document
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
API 参考
快速开始接入教程官网模型与价格控制台
API 参考
快速开始接入教程官网模型与价格控制台
  1. 各种插件/软件使用教程
  • 默认模块
    • 在线调试说明
    • 发出请求
    • Crazyrouter基本介绍
      • API 快速开始指南
    • 聊天(Chat)
      • ChatGpt 接口
        • ChatGPT音频(Audio)
          • 音频转文字 gpt-4o-transcribe
          • 创建翻译(whisper-1,音频→英文,未实测)
        • ChatGPT聊天(Chat)
          • 聊天完成对象
          • 聊天完成块对象
          • 创建聊天补全 (流式)
          • 创建聊天补全 (非流)
          • 创建聊天识图 (流式)
          • 创建聊天识图 (流式) best64
          • 创建聊天识图 (非流)
          • 创建聊天创作图 (非流)
          • 官方Function calling调用
          • 官方N测试
          • 创建聊天函数调用
          • 创建结构化输出
          • 控制推理模型努力程度
          • 创建聊天补全 qwen-mt-turbo
          • 创建聊天补全 deepseek v3.1思考程度 (流式)
          • deepseek-ocr 识别
        • ChatGPT自动补全(Completions)
          • 完成对象
        • ChatGPT嵌入(Embeddings)
          • 嵌入对象
          • 创建嵌入
        • Web 搜索
          • web搜索
        • ChatGPT内容审核(Moderations)
          • 内容审核 Moderations
      • Anthropic Claude 接口
        • 聊天完成对象
        • 聊天完成块对象
        • 计算输入 Token 数 count_tokens [原生格式]
        • PDF支持 [原生格式] base64格式
        • 创建函数调用 (流式) [原生格式]
        • 创建思考聊天 [原生格式]
        • 创建思考聊天
        • 创建聊天补全 (流式)
        • 创建聊天补全 (非流)
        • 创建聊天识图 (流式)
        • 创建聊天识图 (非流)
        • PDF支持 [原生格式]
      • 谷歌Gemini 接口
        • 原生格式
          • 创建上下文缓存 cachedContents [原生格式]
          • 文本生成(非流式)gemini-2.5-pro [原生格式]
          • 文本生成(非流式)gemini-3.1-pro [原生格式]
          • 文本生成+思考-流
          • 图片生成 gemini-2.5-flash-image 控制宽高比
          • 文本生成+思考-流 gemini-3.1-pro [原生格式]
          • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
          • google search
          • 视频理解-url [原生格式] 开发中
          • 图片理解
          • 格式化输出
          • 函数调用
          • 文档理解
          • 代码执行
          • 视频理解
          • URL context
          • 音频理解
        • chat兼容格式
          • gemini图片创作接口 [chat兼容格式]
          • 聊天接口 [chat兼容格式]
          • 聊天接口-思考1 [chat兼容格式]
          • 聊天接口-思考2 [chat兼容格式]
          • 识图接口 [chat兼容格式]
          • 聊天+读取文件接口 [chat兼容格式]
    • 聊天(Responses)
      • Responses API 与 Chat API 对比
      • 创建函数调用
      • 创建模型响应(流式返回)
      • 创建模型响应 (控制思考长度)
      • 创建网络搜索
      • 创建模型响应 gpt-5启用思考
    • 绘画模型
      • 图像对象
      • Midjourney
        • 上传图片
        • 提交Imagine任务
        • 根据任务ID 查询任务状态
        • 根据ID列表查询任务
        • 获取任务图片的seed
        • 执行Action动作
        • 提交Blend任务
        • 提交Describe任务
        • 提交Modal
        • 提交 Video 任务(图生视频)
        • 提交 Edits 任务(局部编辑)
        • 提交 Change 任务(U/V/R 变化)
        • 提交 Simple Change 任务(字符串形式)
        • 提交 Shorten 任务(提示词精简)
        • InsightFace 换脸
        • 获取任务图片(网关转存)
      • GPT Image 系列(gpt-image-2)
        • 创建图片(gpt-image-2,OpenAI images/generations 格式)
        • 编辑图片(gpt-image-2,蒙版 / 多图参考)
      • 即梦绘画
        • 创建绘画
        • 编辑图片
      • 豆包系列
        • doubao-seedream-3-0-t2i-250415
        • doubao-seededit-3-0-i2i-250628
        • doubao-seedream-4-0-250828-文生图
        • doubao-seedream-4-0-250828-图生图
        • doubao-seedream-4-0-250828-多图生图
        • doubao-seedream-4-5-251128 文生图(纯文本输入单图输出)
        • doubao-seedream-4-5-251128 图文生图(单图输入单图输出)
        • doubao-seedream-4-5-251128 多图融合(多图输入单图输出)
        • doubao-seedream-4-5-251128 组图输出(多图输出)
        • doubao-seedream-4-5-251128 单张图生组图
        • doubao-seedream-4-5-251128 多参考图生组图
      • 千问 Qwen-Image 系列
        • qwen-image-2.0-pro
        • qwen-image-edit-2509
    • 视频模型
      • veo 视频生成
        • 视频统一格式
          • 统一视频接口 任务状态
          • 创建视频,带图片
          • 创建视频(参考图)
        • OpenAI 视频格式
      • Kling 快手可灵
        • Callback协议
        • 全能视频 omni-video(kling-v3-omni / kling-video-o1)
        • 图像生成
        • 文生视频
        • 图生视频
        • 查询任务(免费)
        • 多图参考生视频
        • 对口型
        • 视频延长
        • 视频特效
      • 即梦 视频生成
        • 即梦 任务状态
        • 提交视频生成任务
        • 查询视频任务(免费)
      • 海螺 视频生成
        • 海螺 任务状态
        • 首尾帧视频
        • 视频任务状态查询
        • 图生视频
      • 豆包 视频生成
        • seedance-lite-参考图
        • 图生视频-首帧
        • 查询单个任务
        • seedance-lite-首尾帧
        • 图生视频-base64编码
      • sora 视频生成
        • OpenAI官方视频格式
          • openai 查询任务
          • openai 下载视频
          • openai 创建视频,带图片
          • 使用故事板创建视频
          • openai 创建视频,带图片 私有模式
          • openai 创建视频(带Character)
      • 通义万象 视频生成
        • 生成视频
        • 视频查询
      • 统一视频接口(所有视频模型通用)
        • 提交视频生成任务(统一格式)
        • 查询视频任务(统一格式)
    • 系统API
      • 查询异步任务(图片 / 视频通用)
      • 获取单个模型信息
      • 获取令牌列表
      • 新增令牌
      • 获取令牌支持模型
      • 修改令牌
      • 获取账号信息
      • 搜索令牌
      • 删除令牌
    • 文生音乐 Suno
      • Suno 说明
      • Suno 参数
      • 任务提交
        • 生成歌曲(拼接歌曲)
        • 生成歌词
        • 生成歌曲(自定义模式)
        • 歌曲拼接
        • 生成歌曲(续写模式)
        • 生成歌曲(歌手风格)
        • 生成歌曲(上传歌曲二次创作)
      • 查询接口
        • 批量获取任务
        • 查询单个任务
        • 获取wav
    • Python配置方式
      • python 语音转文本(whisper-1)
      • python 使用 Embeddings 向量化
      • python 调用 function-calling demo
      • python langchain 调用 demo
      • python llama_index 配置
      • Python 基础对话
      • Python 识别本地图片(多模态)
      • Python 识别网络图片(多模态)
      • Python 使用 Claude 识别图片
      • python 库流式输出
      • python requests 流式输出 demo
      • python 图像生成与编辑(gpt-image-2)
      • python openai 官方库(AutoGPT / langchain 等)
      • python 连续对话
    • Rerank 重排序模型
      • 重排序
    • php配置方式
      • php使用图片编辑demo
    • nodejs 配置方式
      • nodejs 基础对话
    • 各种插件/软件使用教程
      • CherryStudio配置o4推理级别
      • Cursor 配置教程
      • OpenClaw 安装与配置指南
      • Codex 配置教程
      • N8N 工作流使用 Crazyrouter API 教程
      • Gemini CLI 配置使用教程
      • Claude Code 安装使用教程
      • CherryStudio调用cluade MCP
      • Cherry Studio配置教程
      • dify添加模型
      • cline 配置教程
      • aider 配置教程
      • lobechat 设置教程
      • ChatBox(推荐使用)
      • 开源gpt_academic
      • nextchat 设置教程
      • zotero gpt 配置方法
      • CLAUDE DEV 配置教程
      • 沉浸式翻译 设置gpt翻译
      • 浏览器插件ChatGPT Sidebar
      • chatgpt-on-wechat 配置教程
      • chatgpt GPT Academic 学术优化配置gpt教程
      • RikkaHub 配置教程
      • coze 工作流使用 Crazyrouter API 教程
    • 帮助中心
      • AI返回字段: 思考相关
      • HTTP状态码及其含义
      • 自建图床API
    • 文件上传
      • 临时图片
        • 获取预签名直传地址(大文件推荐)
        • 本地图片临时上传
        • Base64 图片临时上传
        • 远程图片转存为临时 URL
      • Playground
        • Playground 图片上传
      • 废弃接口
        • 旧上传接口(不支持)
    • Decisions API(TypeSafe JEV 判定模型)
      • 创建判定 Decisions
    • 3D 模型生成(混元 hy-3d)
      • 提交 3D 生成任务
      • 查询 3D 生成任务
  • Unified Video API
    • Unified Video
  1. 各种插件/软件使用教程

N8N 工作流使用 Crazyrouter API 教程

n8n 配置教程#

在 n8n 中通过 Crazyrouter 配置 OpenAI 凭证、AI Agent 工作流与 HTTP Request 回退方案,并完成验证与排障
更新日期:2026-06-06
n8n 适合把 LLM 调用接进自动化流程、Agent 节点、审批流和业务系统集成。对接 Crazyrouter 时,推荐先用 n8n 的 OpenAI 凭证路径把一个最小工作流跑通,再决定是否切换到更灵活的 HTTP Request 节点。

概览#

通过 n8n 的 OpenAI 凭证或 AI 节点,你可以把工作流中的模型请求转到 Crazyrouter:
推荐协议:OpenAI-compatible API
推荐接法:n8n OpenAI API credential + 节点级 Base URL
Base URL:https://api.crazyrouter.com/v1
认证方式:sk-... token
推荐首次验证模型:gpt-5.5
如果你的某些节点不支持所需参数或最新模型特性,再回退到 HTTP Request 节点直接调 Crazyrouter 接口。

适合谁用#

想把 AI 接进自动化工作流的人
想做表单、数据库、审批、Webhook 和模型联动的人
想用 AI Agent 节点编排工具调用的人
想通过可视化方式把 Crazyrouter 接进内部业务流程的人

使用协议#

推荐协议:OpenAI-compatible API
在 n8n 中对接 Crazyrouter 时,推荐填写:
https://api.crazyrouter.com/v1
不要填成:
https://api.crazyrouter.com
https://api.crazyrouter.com/v1/chat/completions

前置条件#

项目说明
Crazyrouter 账号先在 crazyrouter.com 注册
Crazyrouter token建议为 n8n 单独创建一个 sk-... token
n8n建议使用当前稳定版,并确认 AI 节点可用
可用模型至少放行一个当天已实测成功的聊天模型,如 gpt-5.5
推荐首批白名单:
gpt-5.5
claude-opus-4-8
gemini-3.1-pro
text-embedding-3-large(如果你会用向量或检索相关节点)

5 分钟快速开始#

创建 n8n 专用 token#

在 Crazyrouter 后台创建一个名为 n8n 的 token。首次建议只开放 gpt-5.5 和 claude-opus-4-8。

添加 OpenAI 凭证#

在 n8n 中进入 Settings → Credentials → Add Credential,选择 OpenAI API 或你当前版本对应的 OpenAI 凭证类型。

填写凭证和节点信息#

先在凭证中填写:
API Key: 你的 sk-...
然后在 OpenAI、OpenAI Chat Model 或相关 AI 节点的 Options 中设置:
Base URL: https://api.crazyrouter.com/v1

创建最小工作流#

新建一个工作流,使用:Manual Trigger → OpenAI Chat Model → Output,模型先填 gpt-5.5。

完成首次验证#

在 OpenAI Chat Model 节点里给一个简单输入,例如 Reply only OK,手动执行工作流。成功返回后,再继续配置 AI Agent 或复杂流程。

最小工作流示例#

OpenAI Chat Model 节点#

{
  "node": "OpenAI Chat Model",
  "parameters": {
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "{{ $json.input }}" }
    ]
  }
}

AI Agent 工作流#

推荐先从最简单的链路开始:
1.
Manual Trigger
2.
AI Agent
3.
Output
在 AI Agent 中选择刚创建的 Crazyrouter 凭证,并先只挂一个简单工具节点,避免把模型问题和工具问题混在一起。

HTTP Request 回退方案#

如果你需要:
某个 n8n AI 节点暂时不支持的新参数
更灵活的请求体控制
更明确地调试 headers、body、stream 参数
可以直接用 HTTP Request 节点调用 Crazyrouter:
Tip: 推荐顺序是:先用 OpenAI 凭证 + 原生 AI 节点跑通;只有在节点能力不够时,再切到 HTTP Request。
Note: 不同 n8n 版本里,Base URL 可能出现在凭证页,也可能出现在具体的 OpenAI / Chat Model 节点 Options 里。当前官方文档更明确提到的是节点级 Base URL 覆盖项,所以接 Crazyrouter 时优先按“凭证填 Key、节点填 Base URL”的思路配置。

推荐模型配置#

使用场景推荐模型原因
默认工作流模型gpt-5.5当天已实测成功,适合作为 n8n 主基线
高质量复杂 Agent 场景claude-opus-4-8适合更复杂解释和长文本任务
Gemini 备用档gemini-3.1-pro适合补充第二条兼容性验证路径
检索 / 向量相关text-embedding-3-large适合后续做向量处理或检索增强
推荐顺序:先用 gpt-5.5 跑通最小工作流,再扩展到 Agent、工具和批量任务。

Token 设置最佳实践#

设置建议说明
专用 token必须n8n 不要和聊天前端、CLI 或 SDK 示例共用 token
模型白名单强烈建议只放行工作流真正会用到的模型
IP 限制固定服务器出口建议开启本地调试、云端混用时谨慎使用
配额上限强烈建议自动化任务可能因为重试、循环、批处理快速消耗额度
环境隔离必须开发、测试、生产工作流使用不同 token
节点分级建议高频任务用低成本模型,关键任务再切高性能模型

验证清单#

OpenAI API 凭证已成功保存
节点级 Base URL 已设置为 https://api.crazyrouter.com/v1
OpenAI Chat Model 节点可正常执行
第一个最小工作流成功返回
如需 Agent,AI Agent 节点也能正常调用模型
Crazyrouter 后台日志能看到对应请求
token 配额和模型白名单符合预期
开发 / 测试 / 生产工作流已做 token 隔离

常见错误与修复#

现象常见原因修复方式
凭证测试失败API Key 错误,或把 Base URL 配置位置填错重新检查 sk-...,并确认 Base URL 填在你的版本实际支持的位置
401 unauthorizedtoken 失效、被删或复制带空格重新生成 token 并替换
403 / model not allowed节点中用到的模型不在白名单里在 Crazyrouter 后台放行对应模型
404Base URL 填成根域名或完整接口路径改成 https://api.crazyrouter.com/v1
工作流不停重试,成本快速增长节点错误后自动重试、循环配置不当限制重试次数,拆分工作流并设置额度
AI Agent 能启动但工具调用不稳定不是凭证问题,而是工具链路太复杂先只保留一个简单工具节点做验证
原生 AI 节点缺少某些参数n8n 节点封装暂未覆盖该特性改用 HTTP Request 节点直接调用 Crazyrouter
批处理任务性能不稳模型能力与节点封装不匹配先回到 gpt-5.5 做最小链路验证,再扩展其他模型

性能与成本建议#

自动化任务默认先用 gpt-5.5 做基线
对循环、批量、定时任务设置更严格的额度与错误告警
把生产工作流和调试工作流拆成不同 token
AI Agent 先少工具、短链路验证,稳定后再扩展复杂编排
发现费用异常时,先看 Crazyrouter 日志和 n8n 执行历史,确认是不是重试或循环造成

FAQ#

n8n 里应该填哪个 Base URL?#

填 https://api.crazyrouter.com/v1。

Base URL 应该填在凭证里还是节点里?#

优先看你当前 n8n 版本的界面。当前官方文档更明确提到的是节点级 Base URL 选项;如果你的凭证页也支持填写,填在那里也可以,但第一次配置建议以节点级设置为准。

我应该先用原生 AI 节点还是 HTTP Request?#

先用原生 OpenAI 凭证和 AI 节点;只有在参数不够或要深度调试时再切到 HTTP Request。

第一个推荐模型是什么?#

先用 gpt-5.5。

为什么工作流费用突然变高?#

通常不是单次请求本身,而是循环、批处理、自动重试或多人共用工作流触发造成。

n8n 一定要拆多个 token 吗?#

强烈建议至少把开发和生产分开;高频任务最好再单独拆分。
Note: n8n 接入 Crazyrouter 后,价值不只是“能调模型”,而是能把模型放进自动化链路里。因此最关键的不是单次对话能否成功,而是要同时控制重试、循环、批量执行和 token 配额。

原教程截图#

image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png

最后校验/修改:2026-09-28(API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com,共 9 处;账号/控制台仍为 https://crazyrouter.com)
Modified at 2026-09-28 13:06:28
Previous
Codex 配置教程
Next
Gemini CLI 配置使用教程
Built with