Crazyrouter API Document
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
API 参考
快速开始接入教程官网模型与价格控制台
API 参考
快速开始接入教程官网模型与价格控制台
  1. chat兼容格式
  • 默认模块
    • 在线调试说明
    • 发出请求
    • 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兼容格式]
            POST
          • 聊天接口 [chat兼容格式]
            POST
          • 聊天接口-思考1 [chat兼容格式]
            POST
          • 聊天接口-思考2 [chat兼容格式]
            POST
          • 识图接口 [chat兼容格式]
            POST
          • 聊天+读取文件接口 [chat兼容格式]
            POST
    • 聊天(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. chat兼容格式

gemini图片创作接口 [chat兼容格式]

默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
默认 API 入口 api.crazyrouter.com
https://api.crazyrouter.com
POST
/v1/chat/completions
用于通过 OpenAI 兼容的 /v1/chat/completions 调用 Gemini 图片创作能力。
适合在已接入 Chat Completions SDK 的项目里直接生成海报、配图、插画概念图和营销素材,无需切换到 Gemini 原生格式。调用时建议明确主体、风格、比例和画面元素,以提高结果一致性。
认证方式为 Authorization: Bearer YOUR_API_KEY;如果你需要原生字段或专用图片参数,可参考同组原生格式接口。

Request

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

Body Params application/json

Examples

Responses

🟢200OK
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.crazyrouter.com/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "max_tokens": 4096,
  "model": "gemini-2.0-flash-exp-image-generation",

  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "主题风格改成红色"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,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
Response Response Example
{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1677652288,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "\n\nHello there, how may I assist you today?"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 9,
        "completion_tokens": 12,
        "total_tokens": 21
    }
}
Modified at 2026-03-19 07:51:00
Previous
音频理解
Next
聊天接口 [chat兼容格式]
Built with