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)
      • 通义万象 视频生成
        • 生成视频
        • 视频查询
      • 统一视频接口(所有视频模型通用)
        • 提交视频生成任务(统一格式)
          POST
        • 查询视频任务(统一格式)
          GET
    • 系统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. 统一视频接口(所有视频模型通用)

提交视频生成任务(统一格式)

默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
POST
/v1/video/generations
Crazyrouter 统一视频接口:一个请求体覆盖所有已接入的视频模型(veo、Sora、Kling、可灵、即梦、豆包 Seedance、海螺、通义万相、Grok 等),由网关按 model 自动路由到对应厂商并转换参数。
POST /v1/video/generations 与 POST /v1/video/create 完全等价(同一处理器),任选其一即可。任务查询用 GET /v1/video/generations/{task_id}、GET /v1/video/create/{task_id} 或 GET /v1/video/query?id=。
计费:提交时按任务一次性预扣,任务最终失败自动退回。视频模型只能在视频接口调用,在 /v1/chat/completions 等接口会被拒绝。
厂商特有参数放在 metadata 中原样透传,例如 Kling 的 {"metadata": {"resolution": "1080p", "camera_control": {...}}}。
代码事实源:router/video-router.go(videoV1Router.POST("/video/generations") 与 POST("/video/create"))、controller/relay.go(RelayTask)、relay/common/relay_info.go(TaskSubmitReq)、relay/channel/task/unified/adaptor.go。
当前可用视频模型(2026-09-28 目录):aigc-video-gv-3.1 / aigc-video-gv-3.1-fast / aigc-video-gv-3.1-lite(Veo 3.1)、aigc-video-kling-1.6 / 2.0 / 2.1 / 2.5-turbo / 2.6 / 3.0 / 3.0-turbo / o1 / avatar / motion-control、doubao-seedance-1-0-lite-t2v / lite-i2v / pro / pro-fast / 1-5-pro / 2-0 / 2-0-fast、hailuo-h3、wan2.2-t2v-plus / i2v-plus / i2v-flash / kf2v-flash / s2v、wan2.5-t2v-preview。完整列表以 GET /v1/models 为准;aigc-video-gv-3.1-fast 之类别名不在目录中会返回 404 model_not_found。

最后校验/修改:2026-09-28(API Base URL 统一为 https://api.crazyrouter.com,示例模型名以 GET /v1/models 返回为准);实测:缺 prompt 返回 400 {code:invalid_request,message:prompt is required};非视频模型返回 404 {code:model_not_found};提交成功返回 {id,task_id,object:video,model,status:queued,progress,created_at}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200成功
application/json
Bodyapplication/json

🟠400参数错误
🟠404模型不存在 / 非视频模型
🟠401令牌无效
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.crazyrouter.com/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "model": "aigc-video-gv-3.1-fast",
  "prompt": "An astronaut stands up and walks away from the camera, cinematic lighting",
  "aspect_ratio": "16:9",
  "seconds": "8",
  "images": [
    "https://media.crazyrouter.com/task-artifacts/tmp-inputs/2026/09/28/user-1/first-frame.png"
  ]
}'
Response Response Example
200 - 成功示例
{
  "id": "1437730573-AigcVideoTask-5654ea4005cedc749b94a20f1c333bbft",
  "task_id": "1437730573-AigcVideoTask-5654ea4005cedc749b94a20f1c333bbft",
  "object": "video",
  "model": "aigc-video-kling-o1",
  "status": "queued",
  "progress": 10,
  "created_at": 1790584863
}
Modified at 2026-09-28 09:00:18
Previous
视频查询
Next
查询视频任务(统一格式)
Built with