# TokenOPS.AI文档

> TokenOPS.AI的官方文档，提供了关于TokenOPS.AI的使用指南、API参考、隐私政策和更新公告。

- [产品简介](https://quwan-b8010aef.mintlify.app/userguide/introduction.md)
- [快速上手](https://quwan-b8010aef.mintlify.app/userguide/quckstart.md)
- [在ChatBox中使用](https://quwan-b8010aef.mintlify.app/userguide/aiclient/chatbox.md)
- [在CherryStudio中使用](https://quwan-b8010aef.mintlify.app/userguide/aiclient/cherrystudio.md)
- [在MaxKB中使用](https://quwan-b8010aef.mintlify.app/userguide/aiclient/maxkb.md)
- [Claude Code 接入指南](https://quwan-b8010aef.mintlify.app/userguide/aiclient/claudecode.md)
- [Codex CLI 接入指南](https://quwan-b8010aef.mintlify.app/userguide/aiclient/codex.md)
- [OpenClaw 配置指南](https://quwan-b8010aef.mintlify.app/userguide/aiclient/openclaw.md)
- [/v1/chat/completions](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/chatcompletions.md): 为给定的聊天对话创建模型响应。您可以在文本生成、视觉和音频指南中了解更多信息。
- [/v1/responses](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/responses.md): 创建一个模型响应。提供文本或图像输入来生成文本或JSON输出。让模型调用您自己的自定义代码或使用内置工具，如网络搜索或文件搜索，将您自己的数据作为模型响应的输入。
- [/v1/images/generations](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/images-generations.md): 根据文本提示创建图像。GPT Image 2.5 还支持在 JSON body 中传入 image（URL 或 Base64）进行图片编辑；需要 mask 时请使用 /v1/images/edits。
- [/v1/images/edits](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/images-edits.md): 根据一张或多张输入图片和提示词创建编辑图像。支持 multipart/form-data 上传本地文件，也支持 application/json 传入图片 URL、纯 Base64 或 Data URI。
- [/v1/videos](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/videos-generations.md): 根据文本提示生成视频内容
- [素材管理](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/assets.md): 通过火山风格的 API 参数管理素材组和视频素材
- [/v1/videos/{video_id}](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/videos-status.md): 查询视频生成任务的当前状态和进度
- [/v1/videos/{video_id}/content](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/videos-content.md): 下载已完成的视频文件内容
- [/v1/videos/{video_id}/remix](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/videos-remix.md): 对现有视频进行有针对性的调整，而无需从头重新生成。系统会重用原始视频的结构、连续性和构图，同时应用您指定的修改。最适合进行单一、明确定义的更改，以保持更多原始保真度。
- [文生图与图片提示](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-diffusion.md): 直接生成；支持图片URL与文本提示组合，具体参数随版本变化。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [查询任务](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-job.md): 使用原始id查询任务，必须使用提交任务时的同一个平台API Key。任务状态为数字0/1/2/3，图片在urls中；查询不会再次生成图片。
- [变化](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-variation.md): 根据来源图片生成变化；不再传model。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [高清](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-upscale.md): 提升来源图片清晰度；操作类型与源版本必须兼容。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [重新生成](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-reroll.md): 使用来源任务参数重新生成；不传imageNo。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [延展](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-pan.md): 向指定方向补充画面；使用支持该操作的来源版本。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [扩图](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-outpaint.md): 扩展画面视野；不保证像素尺寸按scale增加。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [区域重绘](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-inpaint.md): 按蒙版区域重新生成；坐标应与来源图匹配。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [重塑](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-remix.md): 使用新提示词调整来源图片。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [画布编辑](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-edit.md): 在目标画布中设置来源图片的位置与尺寸。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [上传图片编辑](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-upload-paint.md): 通过图片URL和画布发起独立编辑；不是multipart上传接口。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [转绘](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-retexture.md): 根据新提示词对图片进行转绘。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [去背景](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-remove-background.md): 通过可访问的图片URL发起去背景任务。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [Draft增强](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/youchuan-enhance.md): 来源需为支持增强的Draft任务，例如V7 Draft。 所有字段均通过JSON传入；不支持callback。成功提交返回原始任务id，使用GET /v1/tob/job/{jobId}轮询结果。
- [/v1/messages](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/messages.md): 发送结构化的输入消息列表（包含文本和/或图像内容），模型将生成对话中的下一条消息。Messages API可用于单次查询或无状态多轮对话。
- [generateContent](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/generateContent.md): 使用指定模型生成文本内容
- [streamGenerateContent](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/streamGenerateContent.md): 使用指定模型流式生成内容
- [predictLongRunning](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/predictLongRunning.md): 使用Gemini模型创建视频生成任务。支持文本到视频和基于源视频的生成。
- [getGenerateVideosOperation](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/getGenerateVideosOperation.md): 查询视频生成任务的状态和结果。
- [System One（JEV）](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/systemone.md): 通过原生 JEV 协议执行分类、评分和真假概率判断。
- [/v1/files/upload_url](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/files-upload-url.md): 获取一个预签名的文件上传 URL，客户端可以直接使用该 URL 将文件上传到对象存储服务（如 COS、GCS）。适用于大文件上传或客户端直传场景，避免文件数据经过应用服务器中转。返回的 upload_url 包含签名信息，客户端需使用指定的 HTTP method 将文件 PUT/POST 到该 URL。
- [项目 API Key 用量与额度](https://quwan-b8010aef.mintlify.app/api-reference/endpoint/project-list-apikey.md): 分页查询项目 API Key 的人民币额度与用量。
- [OpenAI 基础对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/basic/openai-basic.md): 使用OpenAI兼容接口进行基础文本对话的完整示例代码
- [Claude 基础对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/basic/claude-basic.md): 使用Claude API进行基础文本对话的完整示例代码
- [Gemini 基础对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/basic/gemini-basic.md): 使用Gemini API进行基础文本生成的完整示例代码
- [JEV 决策评估示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/basic/jev-basic.md): 通过平台 System One 接口调用 JEV，一次请求完成分类、评分和是否判断。
- [Responses API 基础调用](https://quwan-b8010aef.mintlify.app/api-reference/examples/basic/responses-basic.md): 使用Responses API进行基础模型推理的示例代码
- [Responses API 思考模式](https://quwan-b8010aef.mintlify.app/api-reference/examples/thinking/responses-thinking.md): 使用Responses API启用思考模式的示例，展示模型的推理过程
- [Responses API 结构化输出](https://quwan-b8010aef.mintlify.app/api-reference/examples/structured/responses-structured.md): 使用Responses API获取JSON格式的结构化输出示例
- [Responses API 工具调用](https://quwan-b8010aef.mintlify.app/api-reference/examples/tools/responses-tools.md): 使用Responses API进行工具调用的示例，让AI模型调用外部函数和服务
- [Responses API 流式请求示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/streaming/responses-streaming.md): 使用Response API进行流式响应的完整示例代码
- [Response API MCP 集成](https://quwan-b8010aef.mintlify.app/api-reference/examples/mcp/responses-mcp.md): 使用Model Context Protocol连接外部工具和系统
- [Batch API 批量对话](https://quwan-b8010aef.mintlify.app/api-reference/examples/batch/batch-api.md): 一次提交多条对话请求，异步查询批次状态，并在任务完成后按实际 Token 后扣费
- [GPT-Realtime 2.0 / 2.1 使用示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/realtime/openai-realtime.md): 通过 ModelHub WebSocket 接口使用 GPT-Realtime 2.0 和 2.1，完成中文文本、语音、图片和工具调用
- [Qwen Realtime 使用示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/realtime/qwen-realtime.md): 通过统一 /v1/realtime 接口使用 Qwen Audio 3.0 Plus / Flash，完成中文文本、语音、函数调用和联网搜索
- [Qwen Realtime 参数兼容矩阵](https://quwan-b8010aef.mintlify.app/api-reference/examples/realtime/qwen-realtime-parameters.md): Qwen Audio 3.0 Plus / Flash 的统一协议参数、百炼扩展、事件映射及验收限制
- [OpenAI 流式对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/streaming/openai-streaming.md): 使用OpenAI兼容接口进行流式对话的完整示例代码
- [Claude 流式对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/streaming/claude-streaming.md): 使用Claude API进行流式对话的完整示例代码
- [Gemini 流式对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/streaming/gemini-streaming.md): 使用Gemini API进行流式文本生成的完整示例代码
- [OpenAI 结构化输出示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/structured/openai-structured.md): 使用OpenAI接口获取JSON格式结构化输出的完整示例代码
- [Claude 结构化输出示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/structured/claude-structured.md): 使用Claude API获取JSON格式结构化输出的完整示例代码
- [Gemini 结构化输出示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/structured/gemini-structured.md): 使用Gemini API获取JSON格式结构化输出的完整示例代码
- [OpenAI 思考模式示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/thinking/openai-thinking.md): 使用OpenAI o1系列模型展示AI思考过程的完整示例代码
- [Claude 思考模式示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/thinking/claude-thinking.md): 使用Claude展示AI逐步分析和推理过程的完整示例代码
- [Gemini 思考模式示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/thinking/gemini-thinking.md): 使用Gemini展示AI逐步分析和推理过程的完整示例代码
- [OpenAI 工具调用示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/tools/openai-tools.md): 使用OpenAI接口进行Function Calling工具调用的完整示例代码
- [Claude 工具调用示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/tools/claude-tools.md): 使用Claude API进行工具调用的完整示例代码
- [Gemini 工具调用示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/tools/gemini-tools.md): 使用Gemini API进行Function Calling工具调用的完整示例代码
- [OpenAI 图片生成 / 编辑示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/openai-image.md): 使用 OpenAI 兼容接口（GPT Image 2.5 / gpt-image-2 / gpt-image-1 系列）生成与编辑图片的完整示例
- [豆包图片生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/douao.md): 使用豆包 API 进行图片生成的完整示例代码
- [千问图片生成与编辑示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/qwen.md): 通过统一图片 API 调用 Qwen Image 3.0、2.1 Pro，并查看参数与用量
- [Nano Banana (Gemini) 图片生成](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/nanobanana.md): 使用 Nano Banana 2.1、Nano Banana 2 和 Pro 进行文生图、参考图编辑及多图合成，包含参数矩阵、图片保存和用量说明
- [即梦图片生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/jimeng.md): 使用即梦 API 进行图片生成的完整示例代码
- [异步图片生成](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/async-image.md): 提交即返回 task_id、轮询拿结果的异步生图接口，统一覆盖 OpenAI（gpt-image 系列）与 Gemini（nano-banana 系列）模型，按"生成成功"后扣费
- [Midjourney 图片生成与编辑示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/images/midjourney.md): Midjourney 图片生成、任务查询与编辑操作的接口用法和代码示例
- [Tripo 3D 生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/3d/tripo.md): 通过 TokenHub 使用 Tripo 3.1、P1、P2，支持文生、单图和多视图 3D 生成。
- [HY-3D 生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/3d/hy.md): 通过 TokenHub 使用 HY-3D 3.0、3.1，支持文字、图片、多视图和草图生成 3D 模型。
- [MiniMax Music 3.0 音乐生成](https://quwan-b8010aef.mintlify.app/api-reference/examples/music/minimax-music-3.md): 通过平台音乐生成接口调用 MiniMax Music 3.0，支持普通歌词、纯音乐和自动歌词模式。
- [豆包 Seed Audio 1.0 音频生成](https://quwan-b8010aef.mintlify.app/api-reference/examples/music/doubao-seed-audio.md): 通过平台统一接口调用 Seed Audio 1.0，支持文字描述、参考音频、参考图片和字幕输出。
- [Sora-2 视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/openai-sora2.md): 使用 OpenAI Sora-2 API 进行视频生成的完整示例代码
- [Veo-3 视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/google-veo3.md): 使用 Veo-3 API 进行视频生成的完整示例代码
- [即梦视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/jimeng.md): 调用即梦视频生成模型的完整示例代码
- [通义万象视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/qwen.md)
- [豆包 Seedance 视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/doubao-seedance.md): 调用 Seedance 2.5 生成视频，并创建素材组、上传和管理参考素材
- [海螺视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/hailuo.md)
- [MiniMax H3 视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/minimax-h3.md): 通过平台 OpenAI 兼容视频接口调用 MiniMax-H3，支持文本、首尾帧及图片/视频/音频参考输入。
- [可灵 Kling 视频生成示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/videos/kling.md): Kling V3、V3 Omni、3.0 Turbo 与 V2.6 的能力矩阵、文生与图生、视频参考与编辑、分镜及完整轮询示例
- [开天语音合成](https://quwan-b8010aef.mintlify.app/api-reference/examples/tts/kaitian.md): 使用开天 TTS 将文本合成为 WAV 音频
- [MiniMax 语音合成](https://quwan-b8010aef.mintlify.app/api-reference/examples/tts/minimax.md): 在 TokenOPS.AI 中使用 MiniMax TTS 将文本转换为语音
- [ElevenLabs 语音合成](https://quwan-b8010aef.mintlify.app/api-reference/examples/tts/elevenlabs.md): 使用 Eleven v3 生成语音，通过 stability 和表达标签控制语音表现
- [火山引擎流式语音识别](https://quwan-b8010aef.mintlify.app/api-reference/examples/asr/volcengine.md): 在 ModelHub 中使用火山引擎 ASR 实时识别语音
- [FunASR 流式语音识别](https://quwan-b8010aef.mintlify.app/api-reference/examples/asr/funasr.md): 在 ModelHub 中使用自部署 FunASR 模型实时识别语音
- [开天非流式语音识别](https://quwan-b8010aef.mintlify.app/api-reference/examples/asr/kaitian.md): 在 ModelHub 中使用开天 ASR 识别音频文件
- [OpenAI 多模态视觉示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/multimodal/openai-vision.md): 使用OpenAI GPT-4V进行图片理解和分析的完整示例代码
- [Claude 多模态对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/multimodal/claude-vision.md): 使用Claude进行图片理解和多模态对话的完整示例代码
- [Gemini 多模态对话示例](https://quwan-b8010aef.mintlify.app/api-reference/examples/multimodal/gemini-vision.md): 使用Gemini进行图片理解和视频理解的完整示例代码
- [Openai](https://quwan-b8010aef.mintlify.app/api-reference/proto_trans/openai.md)
- [错误码](https://quwan-b8010aef.mintlify.app/qa/error-code.md)
- [TokenOPS.AI用户服务协议](https://quwan-b8010aef.mintlify.app/legals/user-terms.md)
- [TokenOPS.AI隐私保护政策](https://quwan-b8010aef.mintlify.app/legals/privacy-policy.md)
- [TokenOPS.AI用户充值服务协议](https://quwan-b8010aef.mintlify.app/legals/recharge-policy.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)
- [youchuan-openapi](/api-reference/youchuan-openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.