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. 各种插件/软件使用教程

zotero gpt 配置方法

Zotero 配置教程#

在 Zotero 中通过支持 OpenAI 兼容接口的 AI 插件接入 Crazyrouter，并明确区分可直接接入与不可直接接入的插件类型
更新日期：2026-06-06
Zotero 本身是文献管理工具，不直接内置 Crazyrouter 配置入口。实际接入方式通常是：先安装一个支持 AI 调用的 Zotero 插件，再在该插件里填写 Crazyrouter 的 OpenAI 兼容地址、API Key 和模型名。
这页最重要的原则不是“随便找个 Zotero AI 插件就能接”，而是先区分插件类型：
可直接接入：插件支持自定义 Base API URL / API URL / Endpoint
不可直接接入或不适合作为公开主线：插件只支持填写官方 OpenAI Key，没有自定义上游地址入口

先说结论#

Crazyrouter 在 Zotero 里的公开推荐接法是：
选择一个支持自定义 OpenAI 兼容地址的 Zotero AI 插件
把基础地址填为 https://api.crazyrouter.com/v1
把 API Key 填为 sk-xxx
第一个验证模型先用 gpt-5.5
Warning: 不是所有 Zotero AI 插件都支持自定义上游地址。如果某个插件只有“填 OpenAI API Key”的入口、没有 Base URL 或 API URL 设置，那么它通常不能直接把请求改走 Crazyrouter。这类插件不应作为公开默认教程。

为什么这样写#

因为目前 Zotero AI 插件生态差异较大：
Zotero 官方文档说明，插件是社区生态，安装方式统一，但能力并不统一
有些插件明确支持自定义 base API URL
也有一些插件公开文档里只写了填 OpenAI API Key
因此 Crazyrouter 的公开文档应优先教用户选择“支持自定义 OpenAI 兼容地址”的插件，而不是默认所有插件都能直接接。

适合谁用#

想在 Zotero 里做论文摘要、翻译、问答的用户
想把文献阅读和 Crazyrouter 模型调用放到一个工作流里的人
想在文献条目、PDF 阅读、笔记整理环节加入 AI 辅助的人
不想自己写脚本，希望直接在 Zotero 图形界面里完成配置的人

前置条件#

项目说明
Crazyrouter 账号先在 crazyrouter.com 注册
Crazyrouter token建议单独为 Zotero 创建一个 token
Zotero 桌面版插件主要运行在桌面端
AI 插件需要支持自定义 OpenAI 兼容地址
文献或 PDF至少准备一篇可测试的条目
建议首轮只放行：
gpt-5.5
claude-opus-4-8
gemini-3.1-pro

安装 Zotero#

Windows#

1.
打开 Zotero 官网下载页
2.
下载 Windows 安装包
3.
运行安装程序
4.
启动 Zotero

macOS#

1.
打开 Zotero 官网下载页
2.
下载 macOS 安装包
3.
拖动 Zotero 到 Applications
4.
启动 Zotero

Linux#

1.
打开 Zotero 官网下载页
2.
下载官方 Linux 包
3.
解压并按 Zotero 官方说明启动
4.
确认 Zotero 可以正常打开
Note: 根据 Zotero 官方文档，插件主要安装在桌面版里。这类 AI 插件通常不适合从移动端作为首轮配置入口。

如何选择 Zotero AI 插件#

公开文档建议优先选择满足下面条件的插件：
能填写 Base API URL、API URL 或 Endpoint
能填写 API Key
能手动填写模型名
最好支持在 Zotero 偏好设置中修改这些参数

推荐的公开判断方法#

如果插件文档里明确写了下面这类能力，通常更适合接 Crazyrouter：
Customize base API URL
API URL
Custom endpoint
Model preferences
例如，zotero-chatgpt 的公开 README 明确提到支持自定义 base API URL；而 Aria 的公开 README 重点写的是填写 OpenAI API Key 和模型偏好，公开说明里没有把“自定义上游地址”作为主线能力。因此在 Crazyrouter 文档里，更稳妥的主线应是“选择支持自定义 OpenAI 兼容地址的插件”。

推荐配置格式#

不同插件字段名可能不同，但第一次建议按下面思路填写：
插件字段推荐值
Base API URL / API URLhttps://api.crazyrouter.com/v1
Full Endpointhttps://api.crazyrouter.com/v1/chat/completions
API Keysk-xxx
Modelgpt-5.5
Tip: 如果插件让你填写的是“基础地址”，优先填 https://api.crazyrouter.com/v1。只有在插件明确要求“完整聊天接口地址”时，再填 https://api.crazyrouter.com/v1/chat/completions。

配置步骤#

第 1 步：创建 Zotero 专用 Crazyrouter token#

第一次建议只放行：
gpt-5.5
claude-opus-4-8
先不要把大量模型一次性全部开放，这样更容易排障。

第 2 步：安装 Zotero 桌面版#

按你的系统安装 Zotero，并确认可以正常导入或查看一篇论文条目。

第 3 步：下载并安装 AI 插件#

根据 Zotero 官方插件安装文档，先下载插件的 .xpi 文件，然后在 Zotero 中：
打开 Tools
进入 Plugins
把 .xpi 文件拖入插件窗口
完成后重启 Zotero。

第 4 步：进入插件设置#

常见入口包括：
Edit → Preferences
插件自己的偏好设置页
插件侧边栏或工具栏入口
不同插件位置可能不同，但核心是找到 API 与模型配置区域。

第 5 步：填写 Crazyrouter 地址、Key 和模型#

如果插件支持基础地址模式，推荐填写：
Base API URL: https://api.crazyrouter.com/v1
API Key: sk-xxx
Model: gpt-5.5
如果插件只支持完整接口地址，改填：
Endpoint: https://api.crazyrouter.com/v1/chat/completions

第 6 步：如插件要求，重启 Zotero#

某些插件在修改 API Key、模型或首选项后需要重启 Zotero 才生效。第一次配置完成后，建议主动重启一次。

第 7 步：用最小学术场景做首轮验证#

先不要上来就做复杂综述。第一次只建议：
选中一篇带摘要的文献
或打开一篇较小的 PDF
执行一次摘要 / 翻译 / 简单问答
测试提示词可以用：
Summarize this paper in 3 bullet points.

推荐验证顺序#

建议按下面顺序推进：
1.
先验证 Zotero 本体和插件都能正常打开
2.
先验证 gpt-5.5
3.
先做单篇摘要
4.
再做翻译
5.
再做多篇对比、长文分析或批量任务

推荐模型#

场景推荐模型原因
首轮链路验证gpt-5.52026 年 3 月 23 日已在生产环境实测成功，最适合先验证插件到 Crazyrouter 的基础链路
深度分析与解释claude-opus-4-8更适合复杂总结、方法比较、长文解释
Gemini 备用档gemini-3.1-pro适合作为第二条兼容性验证路径

适合 Zotero 的使用方式#

单篇论文摘要#

最适合作为首轮验证，因为上下文简单、结果容易判断。

PDF 翻译#

建议先对单页或短段落测试，再逐步扩大范围。

多文献对比#

不建议作为第一步。等单篇摘要和翻译已经稳定后，再尝试多篇对比、综述提纲、研究空白提取等更复杂任务。

笔记整理#

如果插件支持把结果写回 Zotero 笔记，建议先从短摘要开始，不要一开始就批量生成长笔记。

Token 最佳实践#

设置建议说明
专用 token必须Zotero 不要和 IDE、自动化流程共用 token
模型白名单强烈建议先只放行 1 到 2 个模型
配额上限强烈建议长 PDF、多轮总结会放大消耗
分场景 token建议个人学术使用与团队共享分开
泄露处理立即轮换演示、录屏、共享设置页暴露后应立刻换 key

验证清单#

已安装 Zotero 桌面版
已安装支持自定义 OpenAI 兼容地址的 AI 插件
已创建 Zotero 专用 Crazyrouter token
已把基础地址填写为 https://api.crazyrouter.com/v1 或完整接口地址
已正确填写 sk-xxx
已先只配置 gpt-5.5
修改设置后已按需重启 Zotero
已完成单篇摘要或单篇翻译验证
Crazyrouter 后台日志中能看到对应请求

常见错误与修复#

现象常见原因修复方式
插件里只有 OpenAI Key，没有 Base URL插件不支持自定义上游换成支持自定义 Base API URL 或 Endpoint 的插件
401 unauthorizedtoken 错误、复制不完整或失效重新生成 token 并重新填写
404基础地址或完整接口地址填错基础地址改回 https://api.crazyrouter.com/v1，或完整地址改回 https://api.crazyrouter.com/v1/chat/completions
403 / model not allowedtoken 没放行当前模型在 Crazyrouter token 设置中放行该模型
model not found模型名写错先改回 gpt-5.5 做最小验证
插件没反应或设置改了不生效插件需要重启 Zotero重启 Zotero 后重试
摘要失败但接口没报错当前条目没有摘要、PDF 没附件或插件没拿到上下文先换成带摘要或带 PDF 的条目测试
长文处理很慢PDF 太长或任务过重先缩小到单段、单页或单篇摘要

FAQ#

Zotero 能直接配置 Crazyrouter 吗？#

通常不是直接在 Zotero 本体里配置，而是通过支持 OpenAI 兼容接口的 AI 插件配置。

哪类插件最适合接 Crazyrouter？#

优先选择支持 Base API URL、API URL 或 Endpoint 自定义的插件。

如果插件只能填 OpenAI API Key 怎么办？#

这类插件通常不能直接改成 Crazyrouter 上游，不适合作为公开默认方案。更建议换一个支持自定义地址的插件。

基础地址应该填什么？#

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

第一个模型填什么？#

先填 gpt-5.5。

什么时候再做多篇分析或复杂综述？#

等单篇摘要和单篇翻译已经稳定后，再逐步升级任务复杂度。
Note: 如果你的目标是“先让 Zotero 跑通 Crazyrouter”，最关键的不是一开始就追求最强插件，而是先确认你选的插件真的支持自定义 OpenAI 兼容地址，然后用 gpt-5.5 跑通单篇摘要。
最后校验/修改：2026-09-28（API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com，共 11 处；账号/控制台仍为 https://crazyrouter.com）
Modified at 2026-09-28 08:55:34
Previous
nextchat 设置教程
Next
CLAUDE DEV 配置教程
Built with