{
  "name": "hunyuan",
  "display_name": "腾讯混元大模型",
  "description": "## 概述 腾讯混元大模型（Tencent HY）由腾讯公司全链路自研，在高质量内容创作、数理逻辑、代码生成和多轮对话上性能表现卓越，处于业界领先水平。混元 API 支持 AI 搜索联网插件，通过整合腾讯优质的内容生态，提供强大的时新、深度内容获取和 AI 问答能力。 腾讯混元大模型支持的所有接口信息，请参见 [API 概览](https://cloud.tencent.com/document/product/1729/101848)。",
  "domain": "ai",
  "api_version": "2023-09-01",
  "endpoint": "hunyuan.tencentcloudapi.com",
  "actions": [
    {
      "name": "ActivateService",
      "description": "开通服务",
      "status": "online",
      "parameters": [
        {
          "name": "PayMode",
          "type": "integer",
          "required": false,
          "description": "开通之后，是否关闭后付费；默认为0，不关闭；1为关闭",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "ChatCompletions",
      "description": "如需使用OpenAI兼容接口， 请参考文档：[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1729/111007) 腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提...",
      "status": "online",
      "parameters": [
        {
          "name": "Model",
          "type": "string",
          "required": true,
          "description": "模型名称，可选值参考 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中混元生文模型列表。 示例值：hunyuan-turbos-latest 各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。",
          "example": "hunyuan-turbos-latest"
        },
        {
          "name": "Messages",
          "type": "array",
          "required": true,
          "description": "聊天上下文信息。 说明： 1. 长度最多为 40，按对话时间从旧到新在数组中排列。 2. Message.Role 可选值：system、user、assistant、 tool（functioncall场景）。 其中，system 角色可选，如存在则必须位于列表的最开始。user（tool） 和 assistant 需交替出现（一问一答），以 user 提问开始，user（tool）提问结束，其中tool可以连续出现多次，且 Content 不能为空。Role 的顺序示例：[system（可选） us...",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Role",
              "type": "string",
              "required": true,
              "description": "角色，可选值包括 system、user、assistant、 tool。",
              "example": "user"
            },
            {
              "name": "Content",
              "type": "string",
              "required": false,
              "description": "文本内容",
              "example": "你好！"
            },
            {
              "name": "Contents",
              "type": "array",
              "required": false,
              "description": "多种类型内容（目前支持文本、图片和视频），图片支持混元图生文系列模型，视频支持混元视频生文系列模型，详情参考[产品概述](https://cloud.tencent.com/document/product/1729/104753) 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Type",
                  "type": "string",
                  "required": true,
                  "description": "内容类型 注意： 需包含至少一个 Type 为\"text\"的参数。 参数值可选范围：[\"text\", \"image_url\",\"video_url\",\"video_frames\"] 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "text"
                },
                {
                  "name": "Text",
                  "type": "string",
                  "required": false,
                  "description": "当 Type 为 text 时使用，表示具体的文本内容。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "下面图片中是哪个公司的 Logo？"
                },
                {
                  "name": "ImageUrl",
                  "type": "object",
                  "required": false,
                  "description": "图片的url，当 Type 为 image_url 时使用，表示具体的图片内容 如\"https://example.com/1.png\" 或 图片的base64（注意 \"data:image/jpeg;base64,\" 为必要部分）：\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA......\"。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "无",
                  "children": [
                    {
                      "name": "Url",
                      "type": "string",
                      "required": true,
                      "description": "图片的 Url（以 http:// 或 https:// 开头） 注意：此字段可能返回 null，表示取不到有效值。",
                      "example": "https://cloudcache.tencent-cloud.com/qcloud/ui/portal-set/build/About/images/bg-product-series_87d.png"
                    }
                  ]
                },
                {
                  "name": "VideoUrl",
                  "type": "object",
                  "required": false,
                  "description": "当 Type 为 video_url 时使用，标识具体的视频链接内容，如\"https://your-video-path.mp4\"。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "无",
                  "children": [
                    {
                      "name": "Url",
                      "type": "string",
                      "required": false,
                      "description": "视频的url，如\"https://your-video-path.mp4\"，视频文件大小不超过100M。",
                      "example": "https://your-video-path.mp4"
                    },
                    {
                      "name": "Fps",
                      "type": "float",
                      "required": false,
                      "description": "控制视频抽帧频率，取值范围为 0.1 ~5，表示每隔 1/fps 秒抽取一帧，默认为 1s抽取一帧",
                      "example": "1.0"
                    }
                  ]
                },
                {
                  "name": "VideoFrames",
                  "type": "object",
                  "required": false,
                  "description": "当 Type 为 video_frames 时使用，标识具体的视频内图像帧内容，当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "无",
                  "children": [
                    {
                      "name": "Frames",
                      "type": "array",
                      "required": false,
                      "description": "视频图像帧列表，图像帧传url，最大支持传入数量为512帧",
                      "example": "[\"https://cloudcache.tencent-cloud.com/qcloud/ui/portal-set/build/About/images/bg-product-series_87d.png\"]",
                      "item_type": "string"
                    }
                  ]
                }
              ]
            },
            {
              "name": "ToolCallId",
              "type": "string",
              "required": false,
              "description": "当role为tool时传入，标识具体的函数调用 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "call_cpv320k2c3m8fgcs8ja0"
            },
            {
              "name": "ToolCalls",
              "type": "array",
              "required": false,
              "description": "模型生成的工具调用，仅 hunyuan-pro 或者 hunyuan-functioncall 模型支持 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Id",
                  "type": "string",
                  "required": true,
                  "description": "工具调用id",
                  "example": "call_cpv320k2c3m8fgcs8ja0"
                },
                {
                  "name": "Type",
                  "type": "string",
                  "required": true,
                  "description": "工具调用类型，当前只支持function",
                  "example": "function"
                },
                {
                  "name": "Function",
                  "type": "object",
                  "required": true,
                  "description": "具体的function调用",
                  "example": "无",
                  "children": [
                    {
                      "name": "Name",
                      "type": "string",
                      "required": true,
                      "description": "function名称",
                      "example": "get_current_weather"
                    },
                    {
                      "name": "Arguments",
                      "type": "string",
                      "required": true,
                      "description": "function参数，一般为json字符串",
                      "example": "{\\\"location\\\":[\\\"北京\\\",\\\"深圳\\\"],\\\"unit\\\":\\\"celsius\\\"}"
                    }
                  ]
                },
                {
                  "name": "Index",
                  "type": "integer",
                  "required": false,
                  "description": "索引值",
                  "example": "0"
                }
              ]
            },
            {
              "name": "FileIDs",
              "type": "array",
              "required": false,
              "description": "文件标识符。单次最大 50 个文件。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[\"file-YbhlphnNEsjRoKTEXukAqNZZ\"]",
              "item_type": "string"
            },
            {
              "name": "ReasoningContent",
              "type": "string",
              "required": false,
              "description": "思维链内容。用于展示模型思考过程，仅 Hunyuan-T1 系列模型可用。注意：在进行多轮对话时，请**不要**将此字段拼接到 messages 中。请求 messages 的请求参数中包含 reasoning_content，接口将报错。",
              "example": "你好！"
            }
          ]
        },
        {
          "name": "Stream",
          "type": "boolean",
          "required": false,
          "description": "流式调用开关。 说明： 1. 未传值时默认为非流式调用（false）。 2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。 3. 非流式调用时： 调用方式与普通 HTTP 请求无异。 接口响应耗时较长，**如需更低时延建议设置为 true**。 只返回一次最终结果（返回值取 Choices[n].Message 中的值）。 注意： 通过 SDK 调用时，流式和非...",
          "example": "false"
        },
        {
          "name": "StreamModeration",
          "type": "boolean",
          "required": false,
          "description": "流式输出审核开关。 说明： 1. 当使用流式输出（Stream 字段值为 true）时，该字段生效。 2. 输出审核有流式和同步两种模式，**流式模式首包响应更快**。未传值时默认为流式模式（true）。 3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 FinishReason 值为 sensitive。 4. 如果值为 false，则不使用流式输出审核，需要审核完\ufffd\ufffd...",
          "example": "false"
        },
        {
          "name": "TopP",
          "type": "float",
          "required": false,
          "description": "说明： 1. 影响输出文本的多样性。模型已有默认参数，不传值时使用各模型推荐值，不推荐用户修改。 2. 取值区间为 [0.0, 1.0]。取值越大，生成文本的多样性越强。",
          "example": "1.0"
        },
        {
          "name": "Temperature",
          "type": "float",
          "required": false,
          "description": "说明： 1. 影响模型输出多样性，模型已有默认参数，不传值时使用各模型推荐值，不推荐用户修改。 2. 取值区间为 [0.0, 2.0]。较高的数值会使输出更加多样化和不可预测，而较低的数值会使其更加集中和确定。",
          "example": "0.6"
        },
        {
          "name": "EnableEnhancement",
          "type": "boolean",
          "required": false,
          "description": "功能增强（如搜索）开关。 说明： 1. hunyuan-lite 无功能增强（如搜索）能力，该参数对 hunyuan-lite 版本不生效。 2. 未传值时默认关闭开关。 3. 关闭时将直接由主模型生成回复内容，可以降低响应时延（对于流式输出时的首字时延尤为明显）。但在少数场景里，回复效果可能会下降。 4. 安全审核能力不属于功能增强范围，不受此字段影响。 5. 2025-04-20 00:00:00起，由默认开启状态\ufffd...",
          "example": "true"
        },
        {
          "name": "Tools",
          "type": "array",
          "required": false,
          "description": "可调用的工具列表，仅对 hunyuan-turbos、hunyuan-t1、hunyuan-functioncall 模型生效。",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Type",
              "type": "string",
              "required": true,
              "description": "工具类型，当前只支持function",
              "example": "function"
            },
            {
              "name": "Function",
              "type": "object",
              "required": true,
              "description": "具体要调用的function",
              "example": "无",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": true,
                  "description": "function名称，只能包含a-z，A-Z，0-9，\\_或-",
                  "example": "get_current_weather"
                },
                {
                  "name": "Parameters",
                  "type": "string",
                  "required": true,
                  "description": "function参数，一般为json字符串",
                  "example": "无"
                },
                {
                  "name": "Description",
                  "type": "string",
                  "required": false,
                  "description": "function的简单描述",
                  "example": "获取当前地点的天气"
                }
              ]
            }
          ]
        },
        {
          "name": "ToolChoice",
          "type": "string",
          "required": false,
          "description": "工具使用选项，可选值包括 none、auto、custom。说明：1. 仅对 hunyuan-turbo、hunyuan-functioncall 模型生效。2. none：不调用工具；auto：模型自行选择生成回复或调用工具；custom：强制模型调用指定的工具。3. 未设置时，默认值为auto",
          "example": "auto"
        },
        {
          "name": "CustomTool",
          "type": "object",
          "required": false,
          "description": "强制模型调用指定的工具，当参数ToolChoice为custom时，此参数为必填",
          "example": "无",
          "children": [
            {
              "name": "Type",
              "type": "string",
              "required": true,
              "description": "工具类型，当前只支持function",
              "example": "function"
            },
            {
              "name": "Function",
              "type": "object",
              "required": true,
              "description": "具体要调用的function",
              "example": "无",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": true,
                  "description": "function名称，只能包含a-z，A-Z，0-9，\\_或-",
                  "example": "get_current_weather"
                },
                {
                  "name": "Parameters",
                  "type": "string",
                  "required": true,
                  "description": "function参数，一般为json字符串",
                  "example": "无"
                },
                {
                  "name": "Description",
                  "type": "string",
                  "required": false,
                  "description": "function的简单描述",
                  "example": "获取当前地点的天气"
                }
              ]
            }
          ]
        },
        {
          "name": "SearchInfo",
          "type": "boolean",
          "required": false,
          "description": "默认是false，在值为true且命中搜索时，接口会返回SearchInfo",
          "example": "false"
        },
        {
          "name": "Citation",
          "type": "boolean",
          "required": false,
          "description": "搜索引文角标开关。 说明： 1. 配合EnableEnhancement和SearchInfo参数使用。打开后，回答中命中搜索的结果会在片段后增加角标标志，对应SearchInfo列表中的链接。 2. false：开关关闭，true：开关打开。 3. 未传值时默认开关关闭（false）。",
          "example": "false"
        },
        {
          "name": "EnableSpeedSearch",
          "type": "boolean",
          "required": false,
          "description": "是否开启极速版搜索，默认false，不开启；在开启且命中搜索时，会启用极速版搜索，流式输出首字返回更快。",
          "example": "false"
        },
        {
          "name": "EnableMultimedia",
          "type": "boolean",
          "required": false,
          "description": "多媒体开关。 详细介绍请阅读 [多媒体介绍](https://cloud.tencent.com/document/product/1729/111178) 中的说明。 说明： 1. 该参数目前仅对白名单内用户生效，如您想体验该功能请 [联系我们](https://cloud.tencent.com/act/event/Online_service)。 2. 该参数仅在功能增强（如搜索）开关开启（EnableEnhancement=true）并且极速版搜索开关关闭（EnableSpeedSearch=false）时生效。 3. hunyuan-lite 无多媒体能力，该参数对 ...",
          "example": "false"
        },
        {
          "name": "Seed",
          "type": "integer",
          "required": false,
          "description": "说明： 1. 确保模型的输出是可复现的。 2. 取值区间为非0正整数，最大值10000。 3. 非必要不建议使用，不合理的取值会影响效果。",
          "example": "1"
        },
        {
          "name": "ForceSearchEnhancement",
          "type": "boolean",
          "required": false,
          "description": "强制搜索增强开关。 说明： 1. 未传值时默认关闭。 2. 开启后，将强制走AI搜索，当AI搜索结果为空时，由大模型回复兜底话术。",
          "example": "false"
        },
        {
          "name": "Stop",
          "type": "array",
          "required": false,
          "description": "自定义结束生成字符串 调用 OpenAI 的接口时，如果您指定了 `stop` 参数, 模型会停止在匹配到 `stop` 的内容之前。 在调用混元接口时，会停止在匹配到 `stop` 的内容之后。 **说明：** 未来我们可能会修改此行为以便和 OpenAI 保持一致。 但是目前有使用该参数的情况下，开发者需要注意该参数是否会对应用造成影响，以及未来该行为调整时带来的影响。",
          "example": "[\"string\"]",
          "item_type": "string"
        },
        {
          "name": "EnableRecommendedQuestions",
          "type": "boolean",
          "required": false,
          "description": "推荐问答开关。 说明： 1. 未传值时默认关闭。 2. 开启后，在返回值的最后一个包中会增加 RecommendedQuestions 字段表示推荐问答， 最多返回3条。",
          "example": "false"
        },
        {
          "name": "WebSearchOptions",
          "type": "object",
          "required": false,
          "description": "知识注入相关的参数信息",
          "example": "无",
          "children": [
            {
              "name": "Knowledge",
              "type": "array",
              "required": false,
              "description": "表示用户注入的知识信息",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Text",
                  "type": "string",
                  "required": false,
                  "description": "表示具体的知识信息文本",
                  "example": "暴雨+雷暴+8级大风！深圳将迎强对流天气！"
                }
              ]
            },
            {
              "name": "UserLocation",
              "type": "object",
              "required": false,
              "description": "用户位置详细信息",
              "example": "无",
              "children": [
                {
                  "name": "Type",
                  "type": "string",
                  "required": false,
                  "description": "表示位置类型",
                  "example": "approximate"
                },
                {
                  "name": "Approximate",
                  "type": "object",
                  "required": false,
                  "description": "用户近似位置的详细信息",
                  "example": "无",
                  "children": [
                    {
                      "name": "Country",
                      "type": "string",
                      "required": false,
                      "description": "表示 ISO 国家代码",
                      "example": "CN"
                    },
                    {
                      "name": "City",
                      "type": "string",
                      "required": false,
                      "description": "表示城市名称",
                      "example": "深圳"
                    },
                    {
                      "name": "Region",
                      "type": "string",
                      "required": false,
                      "description": "表示区域名称",
                      "example": "南山区"
                    },
                    {
                      "name": "Timezone",
                      "type": "string",
                      "required": false,
                      "description": "表示IANA时区",
                      "example": "Asia/Shanghai"
                    },
                    {
                      "name": "Address",
                      "type": "string",
                      "required": false,
                      "description": "表示详细地址",
                      "example": "深圳市南山区海天二路33号腾讯滨海大厦"
                    }
                  ]
                }
              ]
            },
            {
              "name": "Processes",
              "type": "boolean",
              "required": false,
              "description": "打开开关，会返回搜索状态",
              "example": "true"
            },
            {
              "name": "EnableImage",
              "type": "boolean",
              "required": false,
              "description": "是否开启图文混排",
              "example": "false"
            },
            {
              "name": "EnableMusic",
              "type": "boolean",
              "required": false,
              "description": "是否开启音乐",
              "example": "false"
            }
          ]
        },
        {
          "name": "TopicChoice",
          "type": "string",
          "required": false,
          "description": "用户传入Topic",
          "example": "闲聊"
        },
        {
          "name": "EnableThinking",
          "type": "boolean",
          "required": false,
          "description": "模型思维链开关 说明： 1. 未传值时默认开启，打开模型思维链推理能力。 2. 关闭后，关闭模型思维链推理能力。 开关当前仅对hunyuan-a13b模型生效 示例值：ture",
          "example": "true"
        }
      ],
      "required": [
        "Model",
        "Messages"
      ]
    },
    {
      "name": "ChatTranslations",
      "description": "腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。 3. 请使用 SDK 调用本接口，每种开发语...",
      "status": "online",
      "parameters": [
        {
          "name": "Model",
          "type": "string",
          "required": true,
          "description": "模型名称，可选值包括 hunyuan-translation、hunyuan-translation-lite。 各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。 注意： 不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。",
          "example": "hunyuan-translation"
        },
        {
          "name": "Stream",
          "type": "boolean",
          "required": false,
          "description": "流式调用开关。 说明： 1. 未传值时默认为非流式调用（false）。 2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。 3. 非流式调用时： 调用方式与普通 HTTP 请求无异。 接口响应耗时较长，**如需更低时延建议设置为 true**。 只返回一次最终结果（返回值取 Choices[n].Message 中的值）。 注意： 通过 SDK 调用时，流式和非...",
          "example": "false"
        },
        {
          "name": "Text",
          "type": "string",
          "required": false,
          "description": "待翻译的文本",
          "example": "Playing video games leads to lasting improvements in cognitive abilities."
        },
        {
          "name": "Source",
          "type": "string",
          "required": false,
          "description": "源语言。 支持语言列表: 简体中文：zh，繁体中文：zh-TR，粤语：yue，英语：en，法语：fr，葡萄牙语：pt，西班牙语：es，日语：ja，土耳其语：tr，俄语：ru，阿拉伯语：ar，韩语：ko，泰语：th，意大利语：it，德语：de，越南语：vi，马来语：ms，印尼语：id 以下语种仅 hunyuan-translation 模型支持： 菲律宾语：fil，印地语：hi，波兰语：pl，捷克语：cs，荷兰语：nl，高棉语：km，缅\ufffd...",
          "example": "en"
        },
        {
          "name": "Target",
          "type": "string",
          "required": false,
          "description": "目标语言。 支持语言列表: 简体中文：zh，繁体中文：zh-TR，粤语：yue，英语：en，法语：fr，葡萄牙语：pt，西班牙语：es，日语：ja，土耳其语：tr，俄语：ru，阿拉伯语：ar，韩语：ko，泰语：th，意大利语：it，德语：de，越南语：vi，马来语：ms，印尼语：id 以下语种仅 hunyuan-translation 模型支持： 菲律宾语：fil，印地语：hi，波兰语：pl，捷克语：cs，荷兰语：nl，高棉语：km，\ufffd...",
          "example": "zh"
        },
        {
          "name": "Field",
          "type": "string",
          "required": false,
          "description": "待翻译文本所属领域，例如游戏剧情等",
          "example": "游戏剧情"
        },
        {
          "name": "References",
          "type": "array",
          "required": false,
          "description": "参考示例，最多10个",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Type",
              "type": "string",
              "required": false,
              "description": "翻译文本类型，枚举\"sentence\"表示句子, \"term\"表示术语",
              "example": "sentence"
            },
            {
              "name": "Text",
              "type": "string",
              "required": false,
              "description": "原文",
              "example": "Computer games are a perfect recipe for strengthening our cognitive skills"
            },
            {
              "name": "Translation",
              "type": "string",
              "required": false,
              "description": "译文",
              "example": "电脑游戏是增强我们认知能力的完美秘诀"
            }
          ]
        },
        {
          "name": "GlossaryIDs",
          "type": "array",
          "required": false,
          "description": "关联的术语库 ID 列表，用于术语翻译\u0005，最大支持5个术语库",
          "example": "[\"3177dfae1f8cb180dfcc1bea2ddf19f6\"]",
          "item_type": "string"
        }
      ],
      "required": [
        "Model"
      ]
    },
    {
      "name": "CreateGlossary",
      "description": "创建自定义术语库，在翻译时自动将源语言术语替换为指定的目标语言译文，确保专业术语翻译的一致性和准确性。",
      "status": "online",
      "parameters": [
        {
          "name": "Name",
          "type": "string",
          "required": true,
          "description": "术语库名称，限制50个字符",
          "example": "我的术语库"
        },
        {
          "name": "Source",
          "type": "string",
          "required": true,
          "description": "源语言代码，取值范围：zh(中文)、en(英语)、fr(法语)、pt(葡萄牙语)、es(西班牙语)、ja(日语)、tr(土耳其语)、ru(俄语)、ar(阿拉伯语)、ko(韩语)、th(泰语)、it(意大利语)、de(德语)、vi(越南语)、ms(马来语)、id(印尼语)、yue(粤语)、zh-TR(繁体中文)、hi(印地语)、fil(菲律宾语)、pl(波兰语)、cs(捷克语)、nl(荷兰语)、km(高棉语)、my(缅甸语)、fa(波斯语)、gu(古吉拉特语)、ur(乌尔都语)、te(泰卢\ufffd\ufffd...",
          "example": "en"
        },
        {
          "name": "Target",
          "type": "string",
          "required": true,
          "description": "目标语言代码，取值范围：zh(中文)、en(英语)、fr(法语)、pt(葡萄牙语)、es(西班牙语)、ja(日语)、tr(土耳其语)、ru(俄语)、ar(阿拉伯语)、ko(韩语)、th(泰语)、it(意大利语)、de(德语)、vi(越南语)、ms(马来语)、id(印尼语)、yue(粤语)、zh-TR(繁体中文)、hi(印地语)、fil(菲律宾语)、pl(波兰语)、cs(捷克语)、nl(荷兰语)、km(高棉语)、my(缅甸语)、fa(波斯语)、gu(古吉拉特语)、ur(乌尔都语)、te(泰\ufffd\ufffd...",
          "example": "zh"
        },
        {
          "name": "Description",
          "type": "string",
          "required": false,
          "description": "术语库描述，限制255个字符",
          "example": "desc"
        }
      ],
      "required": [
        "Name",
        "Source",
        "Target"
      ]
    },
    {
      "name": "CreateGlossaryEntry",
      "description": "添加术语条目。",
      "status": "online",
      "parameters": [
        {
          "name": "GlossaryId",
          "type": "string",
          "required": true,
          "description": "术语库 ID",
          "example": "3177dfae1f8cb180dfcc1bea2ddf19f6"
        },
        {
          "name": "Entries",
          "type": "array",
          "required": true,
          "description": "术语条目列表，单次请求限制100个",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "SourceTerm",
              "type": "string",
              "required": true,
              "description": "源语言术语，限制1000字符",
              "example": "Cloud Storage"
            },
            {
              "name": "TargetTerm",
              "type": "string",
              "required": true,
              "description": "目标语言术语，限制1000字符",
              "example": "云存储"
            }
          ]
        }
      ],
      "required": [
        "GlossaryId",
        "Entries"
      ]
    },
    {
      "name": "CreateThread",
      "description": "腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。 3. 请使用 SDK 调用本接口，每种开发语...",
      "status": "online",
      "parameters": [],
      "required": []
    },
    {
      "name": "DeleteGlossary",
      "description": "删除术语库。",
      "status": "online",
      "parameters": [
        {
          "name": "GlossaryId",
          "type": "string",
          "required": true,
          "description": "术语库 ID",
          "example": "452ed9fea07fd1e58be56bd329c28941"
        }
      ],
      "required": [
        "GlossaryId"
      ]
    },
    {
      "name": "DeleteGlossaryEntry",
      "description": "删除术语条目。",
      "status": "online",
      "parameters": [
        {
          "name": "GlossaryId",
          "type": "string",
          "required": true,
          "description": "术语库 ID",
          "example": "36c0033b405c84107d68e1c03788c4f6"
        },
        {
          "name": "Entries",
          "type": "array",
          "required": true,
          "description": "需要更新的术语条目列表，单次请求限制100个",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "EntryId",
              "type": "string",
              "required": true,
              "description": "术语条目 ID",
              "example": "993c20e70d423efed83864d9cc7df288"
            }
          ]
        }
      ],
      "required": [
        "GlossaryId",
        "Entries"
      ]
    },
    {
      "name": "FilesDeletions",
      "description": "删除文件。",
      "status": "online",
      "parameters": [
        {
          "name": "ID",
          "type": "string",
          "required": true,
          "description": "文件标识符。",
          "example": "file-YbhlphnNEsjRoKTEXukAqNZZ"
        }
      ],
      "required": [
        "ID"
      ]
    },
    {
      "name": "FilesList",
      "description": "文件列表。",
      "status": "online",
      "parameters": [
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "分页偏移量。",
          "example": "0"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "每页数量，最大 100。",
          "example": "100"
        }
      ],
      "required": []
    },
    {
      "name": "FilesUploads",
      "description": "上传用于不同用途的文件。 当前用途仅支持 hunyuan 等模型的文档理解。",
      "status": "online",
      "parameters": [
        {
          "name": "Name",
          "type": "string",
          "required": true,
          "description": "文件名。",
          "example": "云API产品简介.pdf"
        },
        {
          "name": "URL",
          "type": "string",
          "required": true,
          "description": "文件链接。目前支持 csv, doc, docx, pdf, ppt, pptx, txt, xls, xlsx 格式，单文件大小限制为100M。",
          "example": "https://main.qcloudimg.com/raw/document/product/pdf/1278_46794_cn.pdf"
        }
      ],
      "required": [
        "Name",
        "URL"
      ]
    },
    {
      "name": "GetEmbedding",
      "description": "腾讯混元 Embedding 接口，可以将文本转化为高质量的向量数据。向量维度为1024维。",
      "status": "online",
      "parameters": [
        {
          "name": "Input",
          "type": "string",
          "required": false,
          "description": "输入文本。总长度不超过 1024 个 Token，超过则会截断最后面的内容。",
          "example": "你好"
        },
        {
          "name": "InputList",
          "type": "array",
          "required": false,
          "description": "输入文本数组。输入数组总长度不超过 50 。",
          "example": "[\"你好\", \"hello\"]",
          "item_type": "string"
        }
      ],
      "required": []
    },
    {
      "name": "GetThread",
      "description": "腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。 3. 请使用 SDK 调用本接口，每种开发语...",
      "status": "online",
      "parameters": [
        {
          "name": "ThreadID",
          "type": "string",
          "required": true,
          "description": "会话 ID",
          "example": "thread_OteLtAcmh7prn7tb8uQ3SJzh"
        }
      ],
      "required": [
        "ThreadID"
      ]
    },
    {
      "name": "GetThreadMessage",
      "description": "腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。 3. 请使用 SDK 调用本接口，每种开发语...",
      "status": "online",
      "parameters": [
        {
          "name": "ThreadID",
          "type": "string",
          "required": true,
          "description": "会话 ID",
          "example": "thread_QPH2Z6DpBhc46V3ylE1JEqTv"
        },
        {
          "name": "MessageID",
          "type": "string",
          "required": true,
          "description": "消息 ID",
          "example": "msg_jtO6oVZmFtIi4T43eswXk6lJ"
        }
      ],
      "required": [
        "ThreadID",
        "MessageID"
      ]
    },
    {
      "name": "GetThreadMessageList",
      "description": "腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。 3. 请使用 SDK 调用本接口，每种开发语...",
      "status": "online",
      "parameters": [
        {
          "name": "ThreadID",
          "type": "string",
          "required": true,
          "description": "会话 ID",
          "example": "thread_OteLtAcmh7prn7tb8uQ3SJzh"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回的消息条数，1 - 100 条",
          "example": "10"
        },
        {
          "name": "Order",
          "type": "string",
          "required": false,
          "description": "排序方式，按创建时间升序（asc）或降序（desc），默认为 desc",
          "example": "desc"
        }
      ],
      "required": [
        "ThreadID"
      ]
    },
    {
      "name": "GetTokenCount",
      "description": "该接口用于计算文本对应Token数、字符数。",
      "status": "online",
      "parameters": [
        {
          "name": "Prompt",
          "type": "string",
          "required": true,
          "description": "输入文本",
          "example": "你是谁"
        }
      ],
      "required": [
        "Prompt"
      ]
    },
    {
      "name": "GroupChatCompletions",
      "description": "如需使用OpenAI兼容接口， 请参考文档：[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1729/111007) 腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提...",
      "status": "online",
      "parameters": [
        {
          "name": "Model",
          "type": "string",
          "required": true,
          "description": "模型名称，可选值包括 hunyuan-large-role-group。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。",
          "example": "hunyuan-large-role-group"
        },
        {
          "name": "Messages",
          "type": "array",
          "required": true,
          "description": "聊天上下文信息。",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Role",
              "type": "string",
              "required": true,
              "description": "角色，可选值包括 system、user、assistant、 tool。",
              "example": "user"
            },
            {
              "name": "Content",
              "type": "string",
              "required": false,
              "description": "文本内容",
              "example": "本小姐可是天才科学家！都来看看我的新发明！"
            },
            {
              "name": "Name",
              "type": "string",
              "required": false,
              "description": "角色名称",
              "example": "布尔玛"
            }
          ]
        },
        {
          "name": "Stream",
          "type": "boolean",
          "required": false,
          "description": "流式调用开关。 说明： 1. 未传值时默认为非流式调用（false）。 2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。 3. 非流式调用时： 调用方式与普通 HTTP 请求无异。 接口响应耗时较长，**如需更低时延建议设置为 true**。 只返回一次最终结果（返回值取 Choices[n].Message 中的值）。 注意： 通过 SDK 调用时，流式和非...",
          "example": "false"
        },
        {
          "name": "TargetCharacterName",
          "type": "string",
          "required": false,
          "description": "目标人物名称",
          "example": "孙悟空"
        },
        {
          "name": "GroupChatConfig",
          "type": "object",
          "required": false,
          "description": "角色描述",
          "example": "无",
          "children": [
            {
              "name": "UserName",
              "type": "string",
              "required": false,
              "description": "人物名称",
              "example": "布尔玛"
            },
            {
              "name": "Description",
              "type": "string",
              "required": false,
              "description": "### 主题：\\n武道修炼与科技创新的碰撞\\n\\n### 地点：\\n布尔玛的实验室\\n\\n### 故事背景：\\n布尔玛正在研发一种新型的龙珠雷达，旨在更精确地定位龙珠的位置。她邀请了孙悟空、天津饭、饺子和雅木茶前来测试新设备。然而，这些武道家们对科技的理解有限，导致了一系列有趣的误解和互动。\\n\\n### 人物关系：\\n- **布尔玛**：天才科学家，负责研发和解释新设备。\\n- **孙悟空**：...",
              "example": "描述"
            },
            {
              "name": "Characters",
              "type": "array",
              "required": false,
              "description": "角色描述",
              "example": "角色描述",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "人物名称",
                  "example": "孙悟空"
                },
                {
                  "name": "SystemPrompt",
                  "type": "string",
                  "required": false,
                  "description": "人物对应SystemPrompt",
                  "example": "你是《七龙珠》中的角色孙悟空，你将与{usernames}等多人展开对话。"
                }
              ]
            }
          ]
        },
        {
          "name": "UserId",
          "type": "string",
          "required": false,
          "description": "用户ID",
          "example": "无"
        },
        {
          "name": "SessionId",
          "type": "string",
          "required": false,
          "description": "对话接口",
          "example": "无"
        }
      ],
      "required": [
        "Model",
        "Messages"
      ]
    },
    {
      "name": "ImageQuestion",
      "description": "如需使用OpenAI兼容接口， 请参考文档：[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1729/111007) 腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提...",
      "status": "online",
      "parameters": [
        {
          "name": "Model",
          "type": "string",
          "required": true,
          "description": "模型名称，可选值包括 hunyuan-vision-image-question。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。",
          "example": "hunyuan-vision-image-question"
        },
        {
          "name": "Messages",
          "type": "array",
          "required": true,
          "description": "聊天上下文信息。说明：1. 长度最多为 40，按对话时间从旧到新在数组中排列。2. Message.Role 可选值：system、user、assistant。其中，system 角色可选，如存在则必须位于列表的最开始。user 和 assistant 需交替出现（一问一答），以 user 提问开始，user提问结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。3. Messages 中 Content 总长度不能超过模型\ufffd\ufffd...",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Role",
              "type": "string",
              "required": true,
              "description": "角色，可选值包括 system、user、assistant。",
              "example": "user"
            },
            {
              "name": "Content",
              "type": "string",
              "required": false,
              "description": "文本内容",
              "example": "你好！"
            },
            {
              "name": "Contents",
              "type": "array",
              "required": false,
              "description": "多种类型内容（目前支持图片和文本），仅 hunyuan-vision 和 hunyuan-turbo-vision 模型支持",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Type",
                  "type": "string",
                  "required": true,
                  "description": "内容类型 注意： 需包含至少一个 Type 为\"text\"的参数。 参数值可选范围：[\"text\", \"image_url\",\"video_url\",\"video_frames\"] 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "text"
                },
                {
                  "name": "Text",
                  "type": "string",
                  "required": false,
                  "description": "当 Type 为 text 时使用，表示具体的文本内容。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "下面图片中是哪个公司的 Logo？"
                },
                {
                  "name": "ImageUrl",
                  "type": "object",
                  "required": false,
                  "description": "图片的url，当 Type 为 image_url 时使用，表示具体的图片内容 如\"https://example.com/1.png\" 或 图片的base64（注意 \"data:image/jpeg;base64,\" 为必要部分）：\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA......\"。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "无",
                  "children": [
                    {
                      "name": "Url",
                      "type": "string",
                      "required": true,
                      "description": "图片的 Url（以 http:// 或 https:// 开头） 注意：此字段可能返回 null，表示取不到有效值。",
                      "example": "https://cloudcache.tencent-cloud.com/qcloud/ui/portal-set/build/About/images/bg-product-series_87d.png"
                    }
                  ]
                },
                {
                  "name": "VideoUrl",
                  "type": "object",
                  "required": false,
                  "description": "当 Type 为 video_url 时使用，标识具体的视频链接内容，如\"https://your-video-path.mp4\"。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "无",
                  "children": [
                    {
                      "name": "Url",
                      "type": "string",
                      "required": false,
                      "description": "视频的url，如\"https://your-video-path.mp4\"，视频文件大小不超过100M。",
                      "example": "https://your-video-path.mp4"
                    },
                    {
                      "name": "Fps",
                      "type": "float",
                      "required": false,
                      "description": "控制视频抽帧频率，取值范围为 0.1 ~5，表示每隔 1/fps 秒抽取一帧，默认为 1s抽取一帧",
                      "example": "1.0"
                    }
                  ]
                },
                {
                  "name": "VideoFrames",
                  "type": "object",
                  "required": false,
                  "description": "当 Type 为 video_frames 时使用，标识具体的视频内图像帧内容，当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "无",
                  "children": [
                    {
                      "name": "Frames",
                      "type": "array",
                      "required": false,
                      "description": "视频图像帧列表，图像帧传url，最大支持传入数量为512帧",
                      "example": "[\"https://cloudcache.tencent-cloud.com/qcloud/ui/portal-set/build/About/images/bg-product-series_87d.png\"]",
                      "item_type": "string"
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "name": "Stream",
          "type": "boolean",
          "required": false,
          "description": "流式调用开关。 说明： 1. 未传值时默认为非流式调用（false）。 2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。 3. 非流式调用时： 调用方式与普通 HTTP 请求无异。 接口响应耗时较长，**如需更低时延建议设置为 true**。 只返回一次最终结果（返回值取 Choices[n].Message 中的值）。 注意： 通过 SDK 调用时，流式和非...",
          "example": "false"
        }
      ],
      "required": [
        "Model",
        "Messages"
      ]
    },
    {
      "name": "ListGlossary",
      "description": "查询术语库。",
      "status": "online",
      "parameters": [
        {
          "name": "Page",
          "type": "integer",
          "required": false,
          "description": "页码，默认 1",
          "example": "1"
        },
        {
          "name": "PageSize",
          "type": "integer",
          "required": false,
          "description": "每页数量，默认 10，最大 100",
          "example": "2"
        }
      ],
      "required": []
    },
    {
      "name": "ListGlossaryEntry",
      "description": "查询术语条目。",
      "status": "online",
      "parameters": [
        {
          "name": "GlossaryId",
          "type": "string",
          "required": true,
          "description": "术语库 ID",
          "example": "3177dfae1f8cb180dfcc1bea2ddf19f6"
        },
        {
          "name": "Page",
          "type": "integer",
          "required": false,
          "description": "页码，默认 1",
          "example": "1"
        },
        {
          "name": "PageSize",
          "type": "integer",
          "required": false,
          "description": "每页数量，默认 10，最大200",
          "example": "2"
        }
      ],
      "required": [
        "GlossaryId"
      ]
    },
    {
      "name": "QueryHunyuanImageChatJob",
      "description": "混元生图（多轮对话）接口基于混元大模型，将根据输入的文本描述生成图像，支持通过多轮对话的方式不断调整图像内容。分为提交任务和查询任务2个接口。 提交任务：输入文本和前置对话 ID 等，提交一个混元生图多轮对话异步任务，获得任务 ID。 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得在上一轮对话基础上继续生成的图像结果。 \ufffd\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": false,
          "description": "任务 ID。",
          "example": "1253534368-1731657099-7276788a-a326-11ef-beeb-525400bba60c-0"
        }
      ],
      "required": []
    },
    {
      "name": "QueryHunyuanImageJob",
      "description": "混元生图接口基于混元大模型，将根据输入的文本描述，智能生成与之相关的结果图。分为提交任务和查询任务2个接口。 提交任务：输入文本等，提交一个混元生图异步任务，获得任务 ID。 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。 并发任务数（并发）说明：并发任务数指能同时处理的任务数量。混元生图默认提供1个并\ufffd\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "任务 ID。",
          "example": "251197749-1731412663-d4e1f224-fa21-40bc-9ee7-4bb13abece6e-0"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "RunThread",
      "description": "腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。 1. 本接口暂不支持返回图片内容。 2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。 3. 请使用 SDK 调用本接口，每种开发语...",
      "status": "online",
      "parameters": [
        {
          "name": "ThreadID",
          "type": "string",
          "required": true,
          "description": "会话 ID",
          "example": "thread_OteLtAcmh7prn7tb8uQ3SJzh"
        },
        {
          "name": "AssistantID",
          "type": "string",
          "required": false,
          "description": "助手 ID（目前未使用，留空）",
          "example": "asst_x39o8phGyiIC8llpaVShxVmL"
        },
        {
          "name": "Model",
          "type": "string",
          "required": false,
          "description": "模型名称，可选值包括 hunyuan-lite、hunyuan-standard、hunyuan-standard-256K、hunyuan-pro、 hunyuan-code、 hunyuan-role、 hunyuan-functioncall、 hunyuan-vision、 hunyuan-turbo。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。",
          "example": "hunyuan-pro"
        },
        {
          "name": "AdditionalMessages",
          "type": "array",
          "required": false,
          "description": "附加消息",
          "example": "[{\"Role\":\"user\",\"Content\":\"你是谁\"}]",
          "item_type": "object",
          "children": [
            {
              "name": "Role",
              "type": "string",
              "required": false,
              "description": "角色",
              "example": "user"
            },
            {
              "name": "Content",
              "type": "string",
              "required": false,
              "description": "内容",
              "example": "你好"
            },
            {
              "name": "Attachments",
              "type": "array",
              "required": false,
              "description": "附件 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[{\"FileID\":\"file-tMjt0CQnvU25GwUDkih4tU4H\"}]",
              "item_type": "object",
              "children": [
                {
                  "name": "FileID",
                  "type": "string",
                  "required": false,
                  "description": "文件 ID 注意：此字段可能返回 null，表示取不到有效值。",
                  "example": "file-tMjt0CQnvU25GwUDkih4tU4H"
                }
              ]
            }
          ]
        },
        {
          "name": "Temperature",
          "type": "float",
          "required": false,
          "description": "说明：1. 影响模型输出多样性，模型已有默认参数，不传值时使用各模型推荐值，不推荐用户修改。2. 取值区间为 [0.0, 2.0]。较高的数值会使输出更加多样化和不可预测，而较低的数值会使其更加集中和确定。",
          "example": "无"
        },
        {
          "name": "TopP",
          "type": "float",
          "required": false,
          "description": "说明：1. 影响输出文本的多样性。模型已有默认参数，不传值时使用各模型推荐值，不推荐用户修改。2. 取值区间为 [0.0, 1.0]。取值越大，生成文本的多样性越强。",
          "example": "无"
        },
        {
          "name": "Stream",
          "type": "boolean",
          "required": false,
          "description": "是否流式输出，当前只允许 true",
          "example": "true"
        },
        {
          "name": "MaxPromptTokens",
          "type": "integer",
          "required": false,
          "description": "运行过程中可使用的 token 最大数量。",
          "example": "0"
        },
        {
          "name": "MaxCompletionTokens",
          "type": "integer",
          "required": false,
          "description": "运行过程中可使用的完成 token 的最大数量。",
          "example": "0"
        },
        {
          "name": "Tools",
          "type": "array",
          "required": false,
          "description": "可调用的工具列表，仅对 hunyuan-pro、hunyuan-turbo、hunyuan-functioncall 模型生效。",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Type",
              "type": "string",
              "required": true,
              "description": "工具类型，当前只支持function",
              "example": "function"
            },
            {
              "name": "Function",
              "type": "object",
              "required": true,
              "description": "具体要调用的function",
              "example": "无",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": true,
                  "description": "function名称，只能包含a-z，A-Z，0-9，\\_或-",
                  "example": "get_current_weather"
                },
                {
                  "name": "Parameters",
                  "type": "string",
                  "required": true,
                  "description": "function参数，一般为json字符串",
                  "example": "无"
                },
                {
                  "name": "Description",
                  "type": "string",
                  "required": false,
                  "description": "function的简单描述",
                  "example": "获取当前地点的天气"
                }
              ]
            }
          ]
        },
        {
          "name": "ToolChoice",
          "type": "string",
          "required": false,
          "description": "工具使用选项，可选值包括 none、auto、custom。说明：1. 仅对 hunyuan-pro、hunyuan-turbo、hunyuan-functioncall 模型生效。2. none：不调用工具；auto：模型自行选择生成回复或调用工具；custom：强制模型调用指定的工具。3. 未设置时，默认值为auto",
          "example": "auto"
        }
      ],
      "required": [
        "ThreadID"
      ]
    },
    {
      "name": "SetPayMode",
      "description": "设置付费模式",
      "status": "online",
      "parameters": [
        {
          "name": "PayMode",
          "type": "integer",
          "required": true,
          "description": "设置后付费状态，0：后付费打开；1：后付费关闭",
          "example": "无"
        }
      ],
      "required": [
        "PayMode"
      ]
    },
    {
      "name": "SubmitHunyuanImageChatJob",
      "description": "混元生图（多轮对话）接口基于混元大模型，将根据输入的文本描述生成图像，支持通过多轮对话的方式不断调整图像内容。分为提交任务和查询任务2个接口。 提交任务：输入文本和前置对话 ID 等，提交一个混元生图多轮对话异步任务，获得任务 ID。 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得在上一轮对话基础上继续生成的图像结果。 \ufffd\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "Prompt",
          "type": "string",
          "required": true,
          "description": "本轮对话的文本描述。 提交一个任务请求对应发起一轮生图对话，每轮对话中可输入一条 Prompt，生成一张图像，支持通过多轮输入 Prompt 来不断调整图像内容。 推荐使用中文，最多可传1024个 utf-8 字符。 输入示例： 第一轮对话：一颗红色的苹果 第二轮对话：将苹果改为绿色 第三轮对话：苹果放在桌子上",
          "example": "请画一个苹果在桌子上"
        },
        {
          "name": "ChatId",
          "type": "string",
          "required": false,
          "description": "上传上一轮对话的 ChatId，本轮对话将在指定的上一轮对话结果基础上继续生成图像。 如果不传代表新建一个对话组，重新开启一轮新的对话。 一个对话组中，最多支持进行100轮对话。",
          "example": "1248907282106990592"
        },
        {
          "name": "LogoAdd",
          "type": "integer",
          "required": false,
          "description": "为生成结果图添加显式水印标识的开关，默认为1。 1：添加。 0：不添加。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。",
          "example": "1"
        },
        {
          "name": "LogoParam",
          "type": "object",
          "required": false,
          "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。",
          "example": "{\"LogoUrl\": \"https://***.cos.ap-guangzhou.myqcloud.com/***/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}",
          "children": [
            {
              "name": "LogoUrl",
              "type": "string",
              "required": false,
              "description": "水印url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg"
            },
            {
              "name": "LogoImage",
              "type": "string",
              "required": false,
              "description": "水印base64，url和base64二选一传入",
              "example": "9j/4QlQaHR0c...N6a2M5ZCI"
            },
            {
              "name": "LogoRect",
              "type": "object",
              "required": false,
              "description": "水印图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配",
              "example": "{\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}",
              "children": [
                {
                  "name": "X",
                  "type": "integer",
                  "required": false,
                  "description": "左上角X坐标",
                  "example": "10"
                },
                {
                  "name": "Y",
                  "type": "integer",
                  "required": false,
                  "description": "左上角Y坐标",
                  "example": "10"
                },
                {
                  "name": "Width",
                  "type": "integer",
                  "required": false,
                  "description": "方框宽度",
                  "example": "20"
                },
                {
                  "name": "Height",
                  "type": "integer",
                  "required": false,
                  "description": "方框高度",
                  "example": "20"
                }
              ]
            }
          ]
        }
      ],
      "required": [
        "Prompt"
      ]
    },
    {
      "name": "SubmitHunyuanImageJob",
      "description": "混元生图接口基于混元大模型，将根据输入的文本描述，智能生成与之相关的结果图。分为提交任务和查询任务2个接口。 提交任务：输入文本等，提交一个混元生图异步任务，获得任务 ID。 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。 并发任务数（并发）说明：并发任务数指能同时处理的任务数量。混元生图默认提供1个并\ufffd\ufffd...",
      "status": "online",
      "parameters": [
        {
          "name": "Prompt",
          "type": "string",
          "required": true,
          "description": "文本描述。 算法将根据输入的文本智能生成与之相关的图像。 不能为空，推荐使用中文。最多可传1024个 utf-8 字符。",
          "example": "雨中, 竹林,  小路"
        },
        {
          "name": "NegativePrompt",
          "type": "string",
          "required": false,
          "description": "反向提示词。 推荐使用中文。最多可传1024个 utf-8 字符。",
          "example": "黑色，雨"
        },
        {
          "name": "Style",
          "type": "string",
          "required": false,
          "description": "绘画风格。 请在 [混元生图风格列表](https://cloud.tencent.com/document/product/1729/105846) 中选择期望的风格，传入风格编号。 不传默认不指定风格。",
          "example": "riman"
        },
        {
          "name": "Resolution",
          "type": "string",
          "required": false,
          "description": "生成图分辨率。 支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3），不传默认使用1024:1024。 如果上传 ContentImage 参考图，分辨率仅支持：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1），不传将自动适配分辨率。如果参考图被用于做风格转换，将生成保持原图长宽比\ufffd\ufffd...",
          "example": "1024:1024"
        },
        {
          "name": "Num",
          "type": "integer",
          "required": false,
          "description": "图片生成数量。 支持1 ~ 4张，默认生成1张。",
          "example": "1"
        },
        {
          "name": "Clarity",
          "type": "string",
          "required": false,
          "description": "超分选项，默认不做超分，可选开启。 x2：2倍超分 x4：4倍超分 在 Resolution 的基础上按比例提高分辨率，例如1024:1024开启2倍超分后将得到2048:2048。",
          "example": "x2"
        },
        {
          "name": "ContentImage",
          "type": "object",
          "required": false,
          "description": "用于引导内容的参考图。 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 8MB，格式支持 jpg、jpeg、png。",
          "example": "无",
          "children": [
            {
              "name": "ImageUrl",
              "type": "string",
              "required": false,
              "description": "图片Url。",
              "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg"
            },
            {
              "name": "ImageBase64",
              "type": "string",
              "required": false,
              "description": "图片Base64。",
              "example": "/9j/4QlQaHR0c...N6a2M5ZCI"
            }
          ]
        },
        {
          "name": "Revise",
          "type": "integer",
          "required": false,
          "description": "prompt 扩写开关。1为开启，0为关闭，不传默认开启。 开启扩写后，将自动扩写原始输入的 prompt 并使用扩写后的 prompt 生成图片，返回生成图片结果时将一并返回扩写后的 prompt 文本。 如果关闭扩写，将直接使用原始输入的 prompt 生成图片。如果上传了参考图，扩写关闭不生效，将保持开启。 建议开启，在多数场景下可提升生成图片效果、丰富生成图片细节。",
          "example": "0"
        },
        {
          "name": "Seed",
          "type": "integer",
          "required": false,
          "description": "随机种子，默认随机。 不传：随机种子生成。 正数：固定种子生成。 扩写开启时固定种子不生效，将保持随机。",
          "example": "1"
        },
        {
          "name": "LogoAdd",
          "type": "integer",
          "required": false,
          "description": "为生成结果图添加显式水印标识的开关，默认为1。 1：添加。 0：不添加。 其他数值：默认按1处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。",
          "example": "1"
        },
        {
          "name": "LogoParam",
          "type": "object",
          "required": false,
          "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。",
          "example": "无",
          "children": [
            {
              "name": "LogoUrl",
              "type": "string",
              "required": false,
              "description": "水印url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg"
            },
            {
              "name": "LogoImage",
              "type": "string",
              "required": false,
              "description": "水印base64，url和base64二选一传入",
              "example": "9j/4QlQaHR0c...N6a2M5ZCI"
            },
            {
              "name": "LogoRect",
              "type": "object",
              "required": false,
              "description": "水印图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配",
              "example": "{\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}",
              "children": [
                {
                  "name": "X",
                  "type": "integer",
                  "required": false,
                  "description": "左上角X坐标",
                  "example": "10"
                },
                {
                  "name": "Y",
                  "type": "integer",
                  "required": false,
                  "description": "左上角Y坐标",
                  "example": "10"
                },
                {
                  "name": "Width",
                  "type": "integer",
                  "required": false,
                  "description": "方框宽度",
                  "example": "20"
                },
                {
                  "name": "Height",
                  "type": "integer",
                  "required": false,
                  "description": "方框高度",
                  "example": "20"
                }
              ]
            }
          ]
        }
      ],
      "required": [
        "Prompt"
      ]
    },
    {
      "name": "TextToImageLite",
      "description": "文生图轻量版接口根据输入的文本描述，智能生成与之相关的结果图。 文生图轻量版默认提供3个并发任务数，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "Prompt",
          "type": "string",
          "required": true,
          "description": "文本描述。 算法将根据输入的文本智能生成与之相关的图像。建议详细描述画面主体、细节、场景等，文本描述越丰富，生成效果越精美。 不能为空，推荐使用中文。最多可传256个 utf-8 字符。",
          "example": "雨中, 竹林,  小路"
        },
        {
          "name": "NegativePrompt",
          "type": "string",
          "required": false,
          "description": "反向文本描述。 用于一定程度上从反面引导模型生成的走向，减少生成结果中出现描述内容的可能，但不能完全杜绝。 推荐使用中文。最多可传256个 utf-8 字符。",
          "example": "黑色"
        },
        {
          "name": "Style",
          "type": "string",
          "required": false,
          "description": "绘画风格。 请在 [文生图轻量版风格列表](https://cloud.tencent.com/document/product/1729/108992) 中选择期望的风格，传入风格编号。不传默认使用201（日系动漫风格）。",
          "example": "101"
        },
        {
          "name": "Resolution",
          "type": "string",
          "required": false,
          "description": "生成图分辨率。 支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3）、1080:1920（9:16）、1920:1080（16:9），不传默认使用768:768。",
          "example": "768:768"
        },
        {
          "name": "LogoAdd",
          "type": "integer",
          "required": false,
          "description": "为生成结果图添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按0处理。 建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。",
          "example": "1"
        },
        {
          "name": "LogoParam",
          "type": "object",
          "required": false,
          "description": "标识内容设置。 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。",
          "example": "{\"LogoUrl\": \"https://xxx.com/logo.jpg\", \"LogoRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}",
          "children": [
            {
              "name": "LogoUrl",
              "type": "string",
              "required": false,
              "description": "水印url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/logo.jpg"
            },
            {
              "name": "LogoImage",
              "type": "string",
              "required": false,
              "description": "水印base64，url和base64二选一传入",
              "example": "9j/4QlQaHR0c...N6a2M5ZCI"
            },
            {
              "name": "LogoRect",
              "type": "object",
              "required": false,
              "description": "水印图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配",
              "example": "{\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}",
              "children": [
                {
                  "name": "X",
                  "type": "integer",
                  "required": false,
                  "description": "左上角X坐标",
                  "example": "10"
                },
                {
                  "name": "Y",
                  "type": "integer",
                  "required": false,
                  "description": "左上角Y坐标",
                  "example": "10"
                },
                {
                  "name": "Width",
                  "type": "integer",
                  "required": false,
                  "description": "方框宽度",
                  "example": "20"
                },
                {
                  "name": "Height",
                  "type": "integer",
                  "required": false,
                  "description": "方框高度",
                  "example": "20"
                }
              ]
            }
          ]
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。",
          "example": "url"
        }
      ],
      "required": [
        "Prompt"
      ]
    },
    {
      "name": "UpdateGlossaryEntry",
      "description": "更新术语条目。",
      "status": "online",
      "parameters": [
        {
          "name": "GlossaryId",
          "type": "string",
          "required": true,
          "description": "术语库 ID",
          "example": "3177dfae1f8cb180dfcc1bea2ddf19f6"
        },
        {
          "name": "Entries",
          "type": "array",
          "required": true,
          "description": "需要更新的术语条目列表，单次请求限制100个",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "EntryId",
              "type": "string",
              "required": true,
              "description": "术语条目 ID",
              "example": "cf0a1f13edae52ef71be9e46fc26ec59"
            },
            {
              "name": "SourceTerm",
              "type": "string",
              "required": false,
              "description": "源语言术语，限制1000字符",
              "example": "Cloud Storage1"
            },
            {
              "name": "TargetTerm",
              "type": "string",
              "required": false,
              "description": "目标语言术语，限制1000字符",
              "example": "云存储1"
            }
          ]
        }
      ],
      "required": [
        "GlossaryId",
        "Entries"
      ]
    }
  ]
}