Crazyrouter API Document
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
API 参考
快速开始接入教程官网模型与价格控制台
API 参考
快速开始接入教程官网模型与价格控制台
  1. 3D 模型生成(混元 hy-3d)
  • 默认模块
    • 在线调试说明
    • 发出请求
    • 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 生成任务
        POST
      • 查询 3D 生成任务
        GET
  • Unified Video API
    • Unified Video
  1. 3D 模型生成(混元 hy-3d)

查询 3D 生成任务

默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
GET
/v1/3d/query/{task_id}
查询 3D 任务状态。status 归一化为 queued / processing / succeeded / failed;成功时 data.url 为模型文件地址,data.format 为 glb / obj / zip。查询免费。
代码事实源:router/video-router.go(videoV1Router.GET("/3d/query/:task_id"))、relay/channel/task/tencent/adaptor.go(maaS3DResultURL)。

最后校验/修改:2026-09-28(API Base URL 统一为 https://api.crazyrouter.com,示例模型名以 GET /v1/models 返回为准);实测:任务不存在返回 HTTP 400 {code:task_not_exist}

Request

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

Header Params

Responses

🟢200成功
application/json
Bodyapplication/json

🟠400任务不存在
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.crazyrouter.com/v1/3d/query/3d_1f9a7c2e' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - 成功示例
{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "succeeded",
    "task_id": "1437730573-AigcVideoTask-5654ea4005cedc749b94a20f1c333bbft",
    "url": "https://media.crazyrouter.com/task-artifacts/2026/09/28/23/textGenerate/1437730573-AigcVideoTask-5654ea4005cedc749b94a20f1c333bbft.mp4"
  }
}
Modified at 2026-09-28 09:02:14
Previous
提交 3D 生成任务
Built with