腾讯云腾讯混元生图对接使用完整指南：从开通到API集成实战

{"type":"doc","content":[{"type":"heading","attrs":{"id":"94116c71-b0a9-4112-a5ce-ecb7027b9774","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"引言：腾讯混元生图能力概览"}]},{"type":"paragraph","attrs":{"id":"c14b5870-281e-4ce6-a60d-762e3c3be794","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"腾讯混元生图是腾讯云推出的一款AI图像生成与处理API技术服务，基于腾讯混元大模型构建，能够根据输入的文本描述或参考图像智能生成高质量的图像内容。与市面上其他AI绘画工具相比，混元生图在中文理解能力上具有显著优势，能更好地支持古诗词意境、水墨剪纸等中国元素风格的生成，同时也覆盖了动漫、游戏、写实等多种风格的高精度图像创作。"}]},{"type":"paragraph","attrs":{"id":"46c0a56a-bf83-496c-ad0e-3d6744983171","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图提供了丰富的接口能力，主要包括：文生图（根据文本描述生成图像）、图生图（根据输入图像和文本描述进行风格转换）、多轮对话生图（通过多轮对话不断调整图像内容）、AI写真（上传人像照片生成风格化头像）等。无论是内容创作者、产品运营人员还是开发者，都可以通过混元生图快速生成高质量的视觉素材。"}]},{"type":"paragraph","attrs":{"id":"7292766b-64fa-4e0b-a110-b86919291d1a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"本文将从零开始，全面讲解腾讯混元生图的对接使用方法，涵盖服务开通、多种对接方式、参数调优、异步任务处理等核心内容，并提供完整的代码示例，帮助开发者快速上手。"}]},{"type":"heading","attrs":{"id":"5d306e01-df83-4f54-b8c0-f01c9ff30b73","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"一、对接前的准备工作"}]},{"type":"heading","attrs":{"id":"1f77fbb1-ecb3-4c21-8a21-94ad81f8adcb","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"1.1 注册腾讯云账号并完成实名认证"}]},{"type":"paragraph","attrs":{"id":"97ee85aa-017f-4eb3-8178-9a76b2e9df46","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"使用腾讯混元生图服务的第一步是注册腾讯云账号。访问腾讯云官网，点击注册按钮，按照指引填写手机号、邮箱等信息完成账号注册。注册完成后，需要进行实名认证，这是调用腾讯云API接口的必要条件。"}]},{"type":"paragraph","attrs":{"id":"949bf395-45ec-4ee6-8307-75a03e7e790b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"需要先登录腾讯云控制台，点击："},{"type":"text","marks":[{"type":"link","attrs":{"href":"https://cloud.tencent.com/act/cps/redirect?redirect=37484&cps_key=c6c11b1aa9ecc74cc31e4c2c4c34cae9","target":"_blank","rel":"noopener noreferrer nofollow","class":null}}],"text":"腾讯云控制台"},{"type":"text","text":"，"}]},{"type":"heading","attrs":{"id":"7505fe58-b416-4faf-9bee-76a3471214d5","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"1.2 开通混元生图服务"}]},{"type":"paragraph","attrs":{"id":"26a87bb3-225b-4311-bc60-1c243eec079d","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"完成账号注册和实名认证后，登录腾讯混元生图控制台。需要注意的是，腾讯混元大模型相关功能正在逐步迁移至TokenHub平台。原控制台将不再新增模型能力并停止支持新购模型服务，用户已购买的模型服务可继续使用暂不受影响。如需开通新的模型服务或使用更多模型能力，建议直接前往TokenHub控制台进行开通。"}]},{"type":"paragraph","attrs":{"id":"77572173-0cae-4c5e-ab8f-6bf1bb0f9a00","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"在TokenHub控制台中，阅读并同意服务条款后单击立即开通，即可获得腾讯混元生图的API接口调用权限。首次开通服务后，系统会发放50次免费调用额度供测试体验，免费额度以一次性资源包形式配送，有效期为1年。"}]},{"type":"heading","attrs":{"id":"da3f0188-212b-4053-8986-34503f020b18","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"1.3 获取API密钥"}]},{"type":"paragraph","attrs":{"id":"afba019b-7b2b-49b5-a542-41d3aa931165","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"调用混元生图API需要一对密钥：SecretId和SecretKey，用于身份认证。在腾讯云控制台的访问管理-API密钥管理页面可以创建和查看密钥。需要特别注意的是，自2023年11月30日起，腾讯云对所有主账号和子账号的密钥关闭了查询SecretKey的功能，仅支持在创建时查看，因此创建后务必及时保存。如果忘记了SecretKey，只能删除旧密钥后重新创建。"}]},{"type":"paragraph","attrs":{"id":"08cd3c4e-bee5-4f52-a05a-210d13804683","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"对于子账号调用，需要主账号进行授权。主账号登录后在用户列表中找到对应的子账户，选择授权并关联策略，搜索并选择QcloudAIARTFullAccess策略即可完成授权。"}]},{"type":"heading","attrs":{"id":"65823120-cf23-4eb1-a72e-7e2ade994eaf","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"二、混元生图的核心接口与参数"}]},{"type":"paragraph","attrs":{"id":"94afb550-6356-41c0-aa99-6b652e2d8be7","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"腾讯混元生图提供了多个版本的接口，每个版本在能力、参数和性能上有所差异。了解这些接口的区别是正确对接的前提。"}]},{"type":"heading","attrs":{"id":"2f161531-cb3e-490b-8cf5-59bcd4127d97","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"2.1 接口版本概览"}]},{"type":"paragraph","attrs":{"id":"4ba29cd0-3190-4009-903b-76504f365292","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图主要包含以下几个版本的接口："}]},{"type":"paragraph","attrs":{"id":"49ef2794-5e68-4100-8bee-4d27bd65d1b2","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"混元生图（极速版）"},{"type":"text","text":"：基于混元大模型，根据输入的文本描述快速生成图片，适合对响应速度要求较高的场景。接口名称为TextToImageLite，请求域名为aiart.tencentcloudapi.com。"}]},{"type":"paragraph","attrs":{"id":"8c26a0a5-871d-46d3-ad08-cb2b85373adb","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"混元生图（2.0）"},{"type":"text","text":"：支持更丰富的参数配置，包括风格选择、参考图输入等，生成质量更高。接口名称为TextToImageRapid。"}]},{"type":"paragraph","attrs":{"id":"909bc69e-cad7-4346-a56b-002624aebc39","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"混元生图（3.0）"},{"type":"text","text":"：最新的生图版本，支持更强大的图像生成能力，可通过OpenAI兼容接口调用。模型标识为HY-Image-V3.0。"}]},{"type":"paragraph","attrs":{"id":"6826e106-cf6e-4175-aaaf-4108a0c96aa7","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"混元生图（多轮对话）"},{"type":"text","text":"：支持通过多轮对话的方式不断调整图像内容，适合需要精细化控制的创作场景。"}]},{"type":"heading","attrs":{"id":"48e01404-d31c-4d9d-be68-e3ebc0834ebc","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"2.2 通用核心参数说明"}]},{"type":"paragraph","attrs":{"id":"e8926fe7-235b-4009-8f93-0f29fb2f4f41","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"不同版本的接口参数略有差异，但以下核心参数是通用的："}]},{"type":"paragraph","attrs":{"id":"c0a78e7c-5b65-46f6-bb0b-b393c6d10535","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"Prompt（提示词）"},{"type":"text","text":"：文本描述，算法根据输入的文本智能生成图像。推荐使用中文，建议详细描述画面主体、细节、场景等，描述越丰富生成效果越精美。极速版和2.0版本最多支持1024个UTF-8字符，3.0版本支持更长的提示词。"}]},{"type":"paragraph","attrs":{"id":"d0116898-7db7-4288-b7c6-bdc37933e99c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"NegativePrompt（反向提示词）"},{"type":"text","text":"：用于减少生成结果中出现不期望的内容。例如不希望出现黑色元素，可以传入"黑色"作为反向提示词。"}]},{"type":"paragraph","attrs":{"id":"ccf44cfa-ae31-481f-aee3-51f1b614a6f2","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"Resolution（分辨率）"},{"type":"text","text":"：生成图的尺寸。支持多种宽高比例：1:1、3:4、4:3、9:16、16:9等。默认使用1024:1024。支持的长边分辨率范围从160px到4096px。"}]},{"type":"paragraph","attrs":{"id":"776695d9-927d-4797-9a6b-422e33bf4f8f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"Seed（随机种子）"},{"type":"text","text":"：控制生成结果的随机性。传入0或不传表示随机生成，传入正数表示固定种子，可以在多次生成中获得相似的结果。"}]},{"type":"paragraph","attrs":{"id":"d682bc93-de95-4015-84e0-eab52a4c654b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"LogoAdd（水印开关）"},{"type":"text","text":"：为生成结果图添加标识的开关，默认为1（添加），建议使用显著标识提示结果图使用了AI绘画技术。"}]},{"type":"paragraph","attrs":{"id":"ab02ca50-555a-4817-9399-a70e1ff51a11","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"RspImgType（返回格式）"},{"type":"text","text":"：返回图像的方式，可选base64或url，默认为base64。如果选择url，生成的图片URL有效期为1小时，需要及时保存。"}]},{"type":"heading","attrs":{"id":"053d5877-6b18-451d-936e-12288dc5bf76","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"三、对接方式一：API Explorer在线调试"}]},{"type":"paragraph","attrs":{"id":"b2ffd5a0-b2d4-428b-bae4-14f3e6d1a6dd","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"API Explorer是腾讯云提供的在线API调试工具，是快速上手和测试接口的最佳方式。无需编写任何代码，通过图形化界面即可完成接口调用并查看返回结果。"}]},{"type":"heading","attrs":{"id":"0fb5aba2-8aac-4fed-8faf-2882824359b7","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"3.1 进入API Explorer"}]},{"type":"paragraph","attrs":{"id":"e5ef4a42-c86a-460d-9156-451c436b5923","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"登录腾讯云控制台后，进入API Explorer页面。在页面中选择产品为"aiart"，版本选择"2022-12-29"，然后选择对应的接口，如TextToImageLite（极速版）或TextToImageRapid（2.0版）。"}]},{"type":"heading","attrs":{"id":"92ed3463-93b7-4998-ac5b-00a12aa2d193","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"3.2 填写参数并发起调用"}]},{"type":"paragraph","attrs":{"id":"c3899f09-04c6-4056-96fc-e8f0515b7c17","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"在API Explorer界面中，按照接口文档的要求填写各个参数。以TextToImageLite为例，必填参数包括Region（地域）和Prompt（提示词）。可选参数包括NegativePrompt、Resolution、Seed、LogoAdd、RspImgType等。"}]},{"type":"paragraph","attrs":{"id":"c6e74d9d-3c9d-407b-917f-eff6efab337e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"填写完成后点击"发起调用"按钮，系统会自动生成签名并发起请求。调用成功后，可以在响应区域查看返回的ResultImage字段，其中包含了生成图像的Base64编码数据或URL。"}]},{"type":"paragraph","attrs":{"id":"df99d16d-1a3c-4702-bb5c-87ab2a0d2fb8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"API Explorer还提供了多语言SDK代码生成功能，可以直接复制Python、Java、Node.js等语言的调用代码，极大地方便了后续的集成开发。"}]},{"type":"heading","attrs":{"id":"858b0cd0-b87e-450e-95aa-fa82a08b1cfe","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"四、对接方式二：cURL命令行调用"}]},{"type":"paragraph","attrs":{"id":"261af910-7070-4241-bdf1-3d283d175381","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图API兼容了OpenAI的接口规范，这意味着可以使用OpenAI协议中的cURL命令来调用混元生图服务。这种方式特别适合快速测试和脚本化调用。"}]},{"type":"heading","attrs":{"id":"965b6573-69da-48f7-a244-cc3442b52905","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"4.1 OpenAI兼容接口的配置"}]},{"type":"paragraph","attrs":{"id":"851cd5c3-ba01-4ef2-a55b-790c8c0a6e39","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"使用OpenAI兼容接口调用混元生图，只需将base_url和api_key替换成混元的相关配置："}]},{"type":"paragraph","attrs":{"id":"30ef209c-9654-4c36-ace0-ca9605c885ac","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"base_url：https://api.cloudai.tencent.com/"}]},{"type":"paragraph","attrs":{"id":"a88dafc0-ffa8-4829-ac13-be99b774f706","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"api_key：需要在TokenHub的接入管理页面进行创建和管理"}]},{"type":"paragraph","attrs":{"id":"20879260-6c2e-4494-b133-b1c3625e9793","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"提交生成接口的完整请求地址为：https://api.cloudai.tencent.com/v1/aiart/submit"}]},{"type":"paragraph","attrs":{"id":"6f3a363b-ea0f-4e9d-b6cd-d54b25fcf069","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"查询任务的接口地址为：https://api.cloudai.tencent.com/v1/aiart/query"}]},{"type":"heading","attrs":{"id":"bb038cb9-2b05-4697-9ae3-f92c5fd90f7c","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"4.2 cURL调用示例"}]},{"type":"paragraph","attrs":{"id":"69a32b19-fd90-4ce4-8867-9a9699798b47","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"以下是一个完整的cURL调用示例，用于提交混元生图3.0的图像生成任务："}]},{"type":"codeBlock","attrs":{"id":"34828d7d-8326-4ec7-8a4d-18af7fda65ad","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"curl --location 'https://api.cloudai.tencent.com/v1/aiart/submit' n--header 'Authorization: sk-e********zzz' n--header 'Content-Type: application/json' n--data '{n"model": "HY-Image-V3.0",n"prompt": "在图片中增加一个橘猫",n"size": "1024:1024",n"images": [n"https://ai.cos.ap-guangzhou.myqcloud.com/cat.png"n],n"extra_body": {n"seed": 84445,n"revise": 0,n"logo_add": 1,n"logo_param": {n"logo_rect": {n"x": 0,n"y": 0,n"width": 100,n"height": 50n},n"logo_url": "https://ai.cos.ap-guangzhou.myqcloud.com/logo.png"n}n}n}'"}]},{"type":"paragraph","attrs":{"id":"d408670d-46dc-4223-8e94-fe33fd40c4e8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"参数说明：model指定为HY-Image-V3.0表示使用混元生图3.0模型；prompt为文本描述；size对应Resolution参数；images对应Images.N参数，用于传入参考图；extra_body中的seed、revise、logo_add等参数与混元生图3.0接口保持一致。"}]},{"type":"heading","attrs":{"id":"d8ea157b-2c59-423c-8b92-f5c08ab22b47","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"五、对接方式三：腾讯云CLI工具"}]},{"type":"paragraph","attrs":{"id":"92e8e1c4-5f72-4f4e-aded-28bd6ac77d74","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"腾讯云命令行工具TCCLI是另一种高效的对接方式，特别适合喜欢终端操作的开发者以及需要批量生成图片的场景。"}]},{"type":"heading","attrs":{"id":"f441e00a-c220-46c9-8ef6-62e82ccd4742","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"5.1 安装与配置TCCLI"}]},{"type":"paragraph","attrs":{"id":"1df0d12b-52fc-406f-a06b-aed8a2068f99","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"首先需要安装腾讯云命令行工具TCCLI。安装完成后，运行以下命令确认安装成功："}]},{"type":"codeBlock","attrs":{"id":"b42648c6-4367-4ad8-82e6-284b8a547f09","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"tccli --version"}]},{"type":"paragraph","attrs":{"id":"1c760c02-d59a-4e1e-a778-ba0ee37317ad","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"然后配置API密钥："}]},{"type":"codeBlock","attrs":{"id":"76047a8b-122c-4d34-a4ee-7d193f6b2282","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"tccli configure"}]},{"type":"paragraph","attrs":{"id":"2b801f9c-ef41-4314-98bc-8ac991817080","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"按照交互式提示输入SecretId、SecretKey、默认地域等信息。配置完成后可以验证配置是否正确："}]},{"type":"codeBlock","attrs":{"id":"36bae161-c63c-457f-8b06-2b53b89a893e","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"tccli configure list"}]},{"type":"heading","attrs":{"id":"3a806a73-6467-46bf-bf0b-aa4cd26dbc97","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"5.2 使用CLI调用生图接口"}]},{"type":"paragraph","attrs":{"id":"8c20d8b0-5251-4445-9d41-d5da11a41484","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"配置完成后，即可使用tccli命令调用混元生图接口。以下是一个完整的调用示例："}]},{"type":"codeBlock","attrs":{"id":"e97f91a7-488c-4f89-9a50-a61cb3aa3de3","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"tccli aiart TextToImageRapid n--cli-unfold-argument n--region ap-guangzhou n--Prompt '画一副马年风格的年画'"}]},{"type":"paragraph","attrs":{"id":"1d1d1b0f-e9cc-4afa-a278-8c44efca6f07","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"命令执行后，几秒钟内会返回JSON格式的响应："}]},{"type":"codeBlock","attrs":{"id":"b28d6bc9-d7cc-4540-9df9-8656b8c9020a","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"{n"Response": {n"RequestId": "e77c02f6-44b1-4e67-a503-844ebb44f067",n"ResultImage": "",n"Seed": 4180030109n}n}"}]},{"type":"paragraph","attrs":{"id":"908db110-e971-4392-80ee-0c926e5951ff","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"其中ResultImage就是生成图片的数据，Seed是随机种子，记录下来后可以在后续调用中传入相同种子以获得相似结果。"}]},{"type":"paragraph","attrs":{"id":"a37b3667-119a-4894-82c7-e31b19185b0c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"CLI方式的优势在于可以轻松集成到Shell脚本中，实现批量图像生成。例如，可以编写一个循环脚本，读取不同的提示词列表，批量调用生图接口并保存结果。"}]},{"type":"heading","attrs":{"id":"b161f826-f120-44d3-b278-0abb2c258136","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"六、对接方式四：Python SDK集成"}]},{"type":"paragraph","attrs":{"id":"68dacbd6-6553-44c8-bc41-06a43bf4e845","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"对于需要在应用程序中集成混元生图能力的开发者，使用腾讯云官方提供的SDK是最佳实践。虽然腾讯云没有为混元生图单独提供SDK，但可以通过通用的腾讯云API SDK（tencentcloud-sdk-python）来调用。"}]},{"type":"heading","attrs":{"id":"e3300ff4-8b33-48a0-b54b-879fe5c6d38e","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"6.1 安装SDK"}]},{"type":"paragraph","attrs":{"id":"9946cbbf-5b6d-440f-b64c-bdcf073e5d51","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"首先安装腾讯云Python SDK："}]},{"type":"codeBlock","attrs":{"id":"2b2cfb5d-0214-4663-b181-1cc702137d60","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"pip install tencentcloud-sdk-python"}]},{"type":"heading","attrs":{"id":"5101ba3a-2fb6-49e9-8d06-e58c9adba579","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"6.2 文生图调用示例"}]},{"type":"paragraph","attrs":{"id":"69270d12-9118-4e26-aeb3-c601f3b7da81","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"以下是一个完整的Python调用示例，使用混元生图2.0接口（TextToImageRapid）生成图像："}]},{"type":"codeBlock","attrs":{"id":"7677c059-9809-4184-ae70-dfdfd8bd818c","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"import jsonnimport base64nfrom tencentcloud.common import credentialnfrom tencentcloud.common.profile.client_profile import ClientProfilenfrom tencentcloud.common.profile.http_profile import HttpProfilenfrom tencentcloud.aiart.v20221229 import aiart_client, modelsnndef text_to_image(prompt, secret_id, secret_key, region="ap-guangzhou"):n# 创建认证对象ncred = credential.Credential(secret_id, secret_key)nn# 配置HTTP参数nhttp_profile = HttpProfile()nhttp_profile.endpoint = "aiart.tencentcloudapi.com"nnclient_profile = ClientProfile()nclient_profile.http_profile = http_profilenn# 创建客户端nclient = aiart_client.AiartClient(cred, region, client_profile)nn# 构造请求nreq = models.TextToImageRapidRequest()nreq.Prompt = promptnreq.Resolution = "1024:1024"nreq.Seed = 1# 固定种子nreq.RspImgType = "base64"nreq.LogoAdd = 1nn# 发起调用nresp = client.TextToImageRapid(req)nn# 解析结果nresult = json.loads(resp.to_json_string())nimage_data = result.get("ResultImage", "")nn# 如果是base64格式，可以解码保存nif image_data and not image_data.startswith("http"):nimage_bytes = base64.b64decode(image_data)nwith open("generated_image.png", "wb") as f:nf.write(image_bytes)nprint("图像已保存为 generated_image.png")nelse:nprint(f"图像URL: {image_data}")nnreturn resultnn# 使用示例nif __name__ == "__main__":nsecret_id = "你的SecretId"nsecret_key = "你的SecretKey"nprompt = "雨中竹林小路，水墨风格"ntext_to_image(prompt, secret_id, secret_key)"}]},{"type":"heading","attrs":{"id":"50ec26f3-8b98-4a2b-8edf-a19bb67e4633","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"6.3 图生图（图像风格化）调用示例"}]},{"type":"paragraph","attrs":{"id":"7ed4446a-5131-4a5c-a9de-ae2adf19fcff","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"除了文生图，混元生图还支持图生图功能，即根据输入图像和文本描述进行风格转换。以下是调用图像风格化接口的示例："}]},{"type":"codeBlock","attrs":{"id":"3e08f92b-3508-45a2-b448-883673871e31","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"from tencentcloud.aiart.v20221229 import modelsnndef image_to_image(prompt, image_url, secret_id, secret_key, region="ap-guangzhou"):ncred = credential.Credential(secret_id, secret_key)nnhttp_profile = HttpProfile()nhttp_profile.endpoint = "aiart.tencentcloudapi.com"nnclient_profile = ClientProfile()nclient_profile.http_profile = http_profilennclient = aiart_client.AiartClient(cred, region, client_profile)nnreq = models.ImageToImageRequest()nreq.Prompt = promptnreq.Image = models.Image()nreq.Image.Url = image_url# 参考图的URLnreq.Resolution = "1024:1024"nreq.RspImgType = "url"nnresp = client.ImageToImage(req)nresult = json.loads(resp.to_json_string())nprint(f"风格化后的图像: {result.get('ResultImage')}")nreturn result"}]},{"type":"paragraph","attrs":{"id":"0af0e4cd-174b-4437-baf1-f02c109d8b40","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"需要注意，当传入Image参数时，Style和Resolution参数不生效，输出图分辨率将保持输入图的分辨率。图片限制为单边分辨率大于128px且小于2048px，文件小于6M，支持jpg、jpeg、png、bmp、tiff、webp格式。"}]},{"type":"heading","attrs":{"id":"e4adcb79-c8ca-43d2-82e4-e529a8d3f519","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"七、异步任务处理机制"}]},{"type":"paragraph","attrs":{"id":"4a2efd8b-318b-45cb-bb04-541fdc363af8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图的大部分接口采用异步任务模式，这对于生成时间较长的复杂图像尤为重要。理解和正确处理异步任务是稳定对接的关键。"}]},{"type":"heading","attrs":{"id":"f08078ee-919d-49e6-ba8e-005a9534a316","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"7.1 异步任务的工作流程"}]},{"type":"paragraph","attrs":{"id":"c7f14a66-1f49-40c7-908f-c6eb496a3d9a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"异步接口的工作流程分为两步："}]},{"type":"paragraph","attrs":{"id":"8dbf5d31-777d-43f2-b839-f9abbbfc5ede","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"第一步：提交任务。调用提交接口（如SubmitHunyuanImageJob），传入Prompt等参数，获得一个任务ID（JobId）。"}]},{"type":"paragraph","attrs":{"id":"92545d1d-8396-4000-b7a1-e4940ce71ca5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"第二步：查询结果。使用任务ID调用查询接口（如QueryHunyuanImageJob），轮询查询任务的处理状态，直到任务完成并获得生成结果。"}]},{"type":"heading","attrs":{"id":"b0524434-9c76-4588-9a2e-739b4bbdc26e","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"7.2 并发限制说明"}]},{"type":"paragraph","attrs":{"id":"616683c0-196a-4c38-8802-7c44ba282dce","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。这意味着如果短时间内提交了多个任务，它们将排队依次处理。开发者需要在代码中合理控制提交频率，或实现任务队列管理。"}]},{"type":"heading","attrs":{"id":"ff17402e-c40c-4a71-9baf-e7b66a9cc6a2","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"7.3 Python异步任务实现示例"}]},{"type":"paragraph","attrs":{"id":"79fa7604-3f9a-4b24-9e6f-ec875e3e2e81","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"以下是一个完整的异步任务处理示例："}]},{"type":"codeBlock","attrs":{"id":"b57a64ff-29ae-4fdb-be8d-d3e711326ca1","language":"javascript","theme":"atom-one-dark","runtimes":0,"isHoverDragHandle":false,"key":"","languageByAi":"javascript"},"content":[{"type":"text","text":"import timenimport jsonnfrom tencentcloud.hunyuan.v20230901 import hunyuan_client, modelsnndef submit_image_job(prompt, secret_id, secret_key, region="ap-guangzhou"):ncred = credential.Credential(secret_id, secret_key)nnhttp_profile = HttpProfile()nhttp_profile.endpoint = "hunyuan.tencentcloudapi.com"nnclient_profile = ClientProfile()nclient_profile.http_profile = http_profilennclient = hunyuan_client.HunyuanClient(cred, region, client_profile)nnreq = models.SubmitHunyuanImageJobRequest()nreq.Prompt = promptnreq.Resolution = "1024:1024"nnresp = client.SubmitHunyuanImageJob(req)nresult = json.loads(resp.to_json_string())njob_id = result.get("JobId")nprint(f"任务已提交，JobId: {job_id}")nreturn job_idnndef query_image_job(job_id, secret_id, secret_key, region="ap-guangzhou"):ncred = credential.Credential(secret_id, secret_key)nnhttp_profile = HttpProfile()nhttp_profile.endpoint = "hunyuan.tencentcloudapi.com"nnclient_profile = ClientProfile()nclient_profile.http_profile = http_profilennclient = hunyuan_client.HunyuanClient(cred, region, client_profile)nnreq = models.QueryHunyuanImageJobRequest()nreq.JobId = job_idnnresp = client.QueryHunyuanImageJob(req)nresult = json.loads(resp.to_json_string())nreturn resultnndef generate_image_with_async(prompt, secret_id, secret_key, max_wait=120):n# 提交任务njob_id = submit_image_job(prompt, secret_id, secret_key)nn# 轮询查询结果nelapsed = 0ninterval = 3# 每3秒查询一次nnwhile elapsed < max_wait:ntime.sleep(interval)nelapsed = intervalnnresult = query_image_job(job_id, secret_id, secret_key)nstatus = result.get("Status")nnif status == "success":nimage_data = result.get("ResultImage")nprint(f"图像生成成功: {image_data}")nreturn resultnelif status == "failed":nprint(f"任务失败: {result.get('ErrorMessage')}")nreturn Nonenelse:nprint(f"任务处理中，状态: {status}")nnprint("任务超时")nreturn None"}]},{"type":"heading","attrs":{"id":"cc907874-8cac-4a23-ab08-63495ff066f8","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"八、多轮对话生图"}]},{"type":"paragraph","attrs":{"id":"2cad299f-aff6-46c4-ad6f-ef91e0115838","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"多轮对话生图是混元生图的一项特色功能，支持通过多轮对话不断调整图像内容，实现精细化创作。"}]},{"type":"heading","attrs":{"id":"798e9df9-ad28-4796-a76c-449f6f1a3b0a","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"8.1 多轮对话的工作原理"}]},{"type":"paragraph","attrs":{"id":"7e3827ea-3ab9-4828-87c9-e0e5455866e8","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"多轮对话生图分为提交任务和查询任务两个接口。每轮对话中可输入一条Prompt，生成一张图像。通过传入上一轮对话的ChatId，本轮对话将在上一轮结果基础上继续生成图像。如果不传ChatId则代表新建一个对话组。一个对话组中最多支持进行100轮对话。"}]},{"type":"heading","attrs":{"id":"6c9f6081-4d3d-4ae0-8ff4-74eb0bd32254","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"8.2 多轮对话的调用流程"}]},{"type":"paragraph","attrs":{"id":"b469e401-f25a-4dc1-93ab-f0f95d62a9dc","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"第一轮对话：调用SubmitHunyuanImageChatJob接口，传入Prompt但不传ChatId，获得JobId和ChatId。"}]},{"type":"paragraph","attrs":{"id":"16ba4d73-5bd5-4c6c-80eb-6d03fceffda5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"查询第一轮结果：调用查询接口获得生成的图像和ChatId。"}]},{"type":"paragraph","attrs":{"id":"6784f7e0-8b88-4018-a405-bca0202d07e1","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"第二轮对话：再次调用SubmitHunyuanImageChatJob接口，传入新的Prompt和上一轮返回的ChatId，在上一轮图像基础上继续调整。"}]},{"type":"paragraph","attrs":{"id":"891c0c63-94b9-4a06-8803-8b6ad61e69b5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"重复以上步骤，直到获得满意的图像。"}]},{"type":"heading","attrs":{"id":"b5a5c5dc-fd5d-431d-b9a5-dfc5f0412629","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"九、风格控制与参数调优"}]},{"type":"heading","attrs":{"id":"68d93e6f-e7af-4d5a-afe1-042f1deb56c9","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"9.1 预置风格列表"}]},{"type":"paragraph","attrs":{"id":"544b764d-e5f0-4807-be17-f8fe9b4a6afe","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图2.0提供了丰富的预置风格供选择。通过Style参数传入风格编号即可控制生成风格："}]},{"type":"paragraph","attrs":{"id":"002e9e69-01fb-4045-83a8-92dfeeb7bbd0","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"1：宫崎骏风格；2：新海诚风格；3：去旅行风格；4：水彩风格；5：像素风格；6：童话世界风格；7：奇趣卡通风格；8：赛博朋克风格；9：极简风格；10：复古风格；11：暗黑系风格；12：波普风风格；13：糖果色风格；14：胶片电影风格；15：素描风格；16：水墨画风格；17：油画风格；18：粉笔风格；19：粘土风格；20：毛毡风格；21：刺绣风格；22：彩铅风格。"}]},{"type":"paragraph","attrs":{"id":"19cb3f8a-7597-451d-b17e-266b530edf23","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"除了使用预置风格，还可以通过Prompt直接描述期望的风格，两种方式可以结合使用。"}]},{"type":"heading","attrs":{"id":"67ba777d-8b85-4f07-b0cc-d4bddf3017c0","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"9.2 Prompt优化技巧"}]},{"type":"paragraph","attrs":{"id":"f3e34bc1-b43b-40c0-bb3c-8e3f308c8ba9","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"编写高质量的Prompt是获得理想生成效果的关键。以下是一些实用的优化建议："}]},{"type":"paragraph","attrs":{"id":"cfb876f6-4b06-46e8-b540-b3a740e3dee1","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"详细描述画面主体、细节、场景等，文本描述越丰富生成效果越精美。例如，不要只写"一只猫"，而应该写"一只橘色的短毛猫坐在窗台上，阳光从窗外斜射进来，画面温馨"。"}]},{"type":"paragraph","attrs":{"id":"350be852-375f-406c-8c57-b8449303c10d","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"使用中文描述，混元生图对中文的理解能力更强。可以利用反向提示词排除不想要的内容。开启Revise参数可以启用自动扩写功能，帮助优化提示词。固定Seed种子可以获得可重现的结果，便于对比不同参数的效果。"}]},{"type":"heading","attrs":{"id":"1e1c1858-1abc-4aad-ad24-165e770f66a5","textAlign":"inherit","indent":0,"level":2,"isHoverDragHandle":false},"content":[{"type":"text","text":"十、常见问题与解决方案"}]},{"type":"heading","attrs":{"id":"b45504ce-5022-4478-9155-b385cc364600","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"问题1：调用接口返回权限错误怎么办？"}]},{"type":"paragraph","attrs":{"id":"f4365afa-bc10-4890-ae15-097d1718a4ce","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"首先确认是否已开通混元生图服务。其次检查API密钥是否正确，子账号需要确认主账号已授予QcloudAIARTFullAccess策略。最后确认接口的地域参数是否正确，目前混元生图接口仅支持ap-guangzhou地域。"}]},{"type":"heading","attrs":{"id":"448dc387-cd19-4165-8101-2664d3988046","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"问题2：生成速度慢或任务超时怎么办？"}]},{"type":"paragraph","attrs":{"id":"8a436c87-e3c2-4a77-8ff0-ce2a0d2a242a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"混元生图默认只有1个并发，如果提交了多个任务会排队处理。建议合理控制提交频率，或实现任务队列管理。对于超时任务，可以适当增加轮询等待时间，复杂图像的生成可能需要更长时间。"}]},{"type":"heading","attrs":{"id":"beffb026-ef59-45ec-9803-b46a47a8c7ac","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"问题3：生成的图像质量不理想怎么办？"}]},{"type":"paragraph","attrs":{"id":"403c8c0a-73db-432a-b8c7-45cdd146f7e5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"优化Prompt描述，提供更详细、更具体的文本描述。尝试使用不同的风格参数。开启Revise自动扩写功能。固定Seed后微调其他参数进行对比实验。"}]},{"type":"heading","attrs":{"id":"72811865-7c34-43f3-a96d-441d37c38efb","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"问题4：如何处理返回的Base64图像数据？"}]},{"type":"paragraph","attrs":{"id":"83f481c6-0442-433f-ab50-c288c5f171c6","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"返回的ResultImage字段如果是Base64编码，可以使用各语言的Base64解码库进行解码后保存为图片文件。Python示例中已经展示了如何处理Base64数据。"}]},{"type":"heading","attrs":{"id":"0a861829-0f77-4647-91cd-6e9fea2d3b46","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"问题5：TokenHub迁移对现有服务有什么影响？"}]},{"type":"paragraph","attrs":{"id":"994c3977-97bf-4933-b336-c1c66fe47590","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"腾讯混元大模型相关功能正在逐步迁移至TokenHub。原平台将不再新增模型能力并停止支持新购模型服务，但用户已购买的模型服务可继续使用暂不受影响。新用户建议直接前往TokenHub开通服务。"}]},{"type":"heading","attrs":{"id":"a23f189a-ffa2-4a7d-a177-0ef4b2748f04","textAlign":"inherit","indent":0,"level":3,"isHoverDragHandle":false},"content":[{"type":"text","text":"问题6：如何查看调用次数和费用？"}]},{"type":"paragraph","attrs":{"id":"872cf0c1-bfa5-42ee-a03e-f648fb465d1e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"首次开通服务会赠送50次免费调用额度。可以在腾讯云控制台的费用中心查看详细的调用记录和账单。混元生图支持预付费资源包和后付费两种计费方式，可以根据实际使用情况选择合适的计费模式。"}]}]}","createTime":1782891978,"ext":{"closeTextLink":0,"comment_ban":0,"description":"","focusRead":0},"favNum":0,"html":"","isOriginal":0,"likeNum":0,