最佳实践

[TOC] ##一、准备工作 ###1.下载Codex(ChatGPT) 软件下载地址: https://openai.com/zh-Hans-CN/codex/ 如图所示,点击下载按钮进行下载: ![](https://oss.showapi.com/doc/3989/22/7924d8f125a4_1783819775430.jpg?x-oss-process=image/resize,p_100) 下载时间较长,具体时间依据您的网速而定。下载完成后会自动进行安装,无需人工干预。 本教程以Windows 11作为软件的演示环境,软件当前的版本号为26.709.11516,如果您安装的版本、操作系统等,与我们演示的差异较大,请参考官方网站。 安装成功后,软件的名称叫“ChatGPT”,打开的界面: ![](https://oss.showapi.com/doc/3989/22/8e8fe1cf657c_1783820724408.png?x-oss-process=image/resize,p_100) ###2.配置ChatGPT(已有账号可忽略该步骤) 首先,要配置访问GPT、Claude等国外模型的密钥。国内环境无法直接使用这些模型,可以通过一些模型代理网站间接的访问我们需要调用的模型。如果您有自己熟悉的代理网站,请使用自己熟知的。这里推荐几个网站,大家自行决定使用哪个作为模型代理访问的网站,其中的风险您自行承担: https://ctmoai.com/login https://aicodewith.com/zh/login https://agentrouter.org/ https://www.likeai520.cc/ * 以上网址可能随着国内外的政策调整导致模型调用异常,甚至上述网站也可能随时间推移也无法访问。在调用前期请做好充分测试和调研,充值金额建议小金额、批量多次的方式进行充值,以降低异常情况带来的损失。 * 我们以 https://ctmoai.com 这个网站为例,调用当前该网站支持的最新模型-GPT5.5,为大家演示整个配置过程。 注册 ctmoai.com网站的账号并登录: ![](https://oss.showapi.com/doc/3989/22/7469a4477018_1783822863473.jpg?x-oss-process=image/resize,p_100) 充值: ![](https://oss.showapi.com/doc/3989/22/46c5bbc21f73_1783823169548.jpg?x-oss-process=image/resize,p_100) 创建密钥(此处已经创建了一个名为show_test的密钥): ![](https://oss.showapi.com/doc/3989/22/c402e34f554f_1783823383082.jpg?x-oss-process=image/resize,p_100) 查看帮助文档 https://ctmoai.com/_home/jiaocheng/ , 也可以使用以下位置的"使用密钥",参考相关说明来配置: ![](https://oss.showapi.com/doc/3989/22/90c6074a962c_1783823660012.jpg?x-oss-process=image/resize,p_100) 注意,我们选择的路径是"Codex CLI"->"Windows",此处展示的信息是实际可用的,无需做过多的调整: ![](https://oss.showapi.com/doc/3989/22/e50b1b647269_1783823811368.png?x-oss-process=image/resize,p_100) 具体配置如下: 1.编辑config.toml 打开文件,路径在"C:\Users\{你自己的用户名}\.codex\config.toml",粘贴以下内容到文档的最前面: ``` model_provider = "OpenAI" model = "gpt-5.5" review_model = "gpt-5.5" model_reasoning_effort = "xhigh" disable_response_storage = true network_access = "enabled" windows_wsl_setup_acknowledged = true [model_providers.OpenAI] name = "OpenAI" base_url = "https://ctmoai.com" wire_api = "responses" requires_openai_auth = true [features] goals = true ``` 2.编辑auth.json 打开文件,路径在"C:\Users\{你自己的用户名}\.codex\auth.json",如果没有该文件,请在.codex文件夹下创建一个名为"auth.json"的文件,并粘贴以下内容: ``` { "OPENAI_API_KEY": "sk-a2f......fbb8" } ``` 其中,以“sk-”开头的字符串要替换成之前您创建的“API密钥” 3.重启ChatGPT软件,点击“使用其他方式登录”,然后输入sk-开头的API密钥,进入以下界面,按照您的实际情况和操作提示进行选择: ![](https://oss.showapi.com/doc/3989/22/1e59bc2fbc68_1783825159561.png?x-oss-process=image/resize,p_100) 4.所有步骤完成后,出现以下界面: ![](https://oss.showapi.com/doc/3989/22/bfebc0c88eaa_1783825293696.png?x-oss-process=image/resize,p_100) 配置界面为中文: ![](https://oss.showapi.com/doc/3989/22/1057d8e1715c_1783825389232.png?x-oss-process=image/resize,p_100) ![](https://oss.showapi.com/doc/3989/22/24ef0fd495e7_1783825439215.png?x-oss-process=image/resize,p_100) 然后,退出ChatGPT进程,再启动软件,中文界面才生效: ![](https://oss.showapi.com/doc/3989/22/c97d3009b5a6_1783825667291.png?x-oss-process=image/resize,p_100) ###3.注册ShowAPI平台账号(已注册请忽略该步骤) 注册地址:https://www.showapi.com/auth/reg ![](https://oss.showapi.com/doc/3989/4/a138e25cee90_1782735365134.png?x-oss-process=image/resize,p_100) ###4.登录ShowAPI平台以获取AppKey(已有AppKey可忽略该步骤) 登录地址:https://www.showapi.com/auth/login 登录成功后,具体操作步骤依次为:点击右上角"控制台" -> 左侧菜单的"接口使用者" -> "appKey管理" 如下图所示: ![](https://oss.showapi.com/doc/3989/4/8a92594fa3d7_1782736191682.png?x-oss-process=image/resize,p_100) 根据个人需要,可以创建独立的应用和appKey,也可以设置访问IP或接口权限。 点击“查看”按钮,并输入注册时的密码,即可查看和复制appKey,后续调用Skills时会用到该appKey。 ##二、下载技能包 ###1.进入工作流市场 进入“万维易源”平台首页:https://www.showapi.com/ 如未登录,请先登录。然后,点击导航栏的“AI工作流”: ![](https://oss.showapi.com/doc/3989/12/908fa6f20f6e_1782877262566.jpg?x-oss-process=image/resize,p_100) 或者直接进入如下地址:https://www.showapi.com/ai/promptflow 点击页面下方的“搜索工作流市场” ![](https://oss.showapi.com/doc/3989/12/c23ebcb7bb1b_1782736372041.jpg?x-oss-process=image/resize,p_100) ###2.下载skill(技能) 首先,查阅工作流 ![](https://oss.showapi.com/doc/3989/15/918ee2282b48_1783476322733.jpg?x-oss-process=image/resize,p_100) 工作流市场中的内容会不断变化,您看到的内容和此处展示的可能不一致。 我们以“文创设计”工作流技能包的安装为例进行演示(其他技能包的使用步骤完全一致)。在搜索框住输入“文创设计”,回车,就可以找到对应的工作流: ![](https://oss.showapi.com/doc/3989/15/057cb0e3659f_1783476423731.png?x-oss-process=image/resize,p_100) 点击工作流卡片,然后依次点击: ① "开发集成(Skills)" -> ② "Agent Skill" -> ③ "下载技能包" ![](https://oss.showapi.com/doc/3989/15/326e425ce391_1783477758463.jpg?x-oss-process=image/resize,p_100) 需要留意您下载技能包的存放位置,在稍后的步骤中需要选择该技能包。 ##二、安装技能包 ###1.打开软件 同时,参考聊天区域右下角,切换模型为GPT5.5 ![](https://oss.showapi.com/doc/3989/22/ebc598cef18c_1783825839444.png?x-oss-process=image/resize,p_100) ###2.导入技能包 ChatGPT中创建技能包需要用到github仓库 ![](https://oss.showapi.com/doc/3989/22/4038e5ecb661_1783826084986.png?x-oss-process=image/resize,p_100) ![](https://oss.showapi.com/doc/3989/22/224761328f5b_1783826137759.png?x-oss-process=image/resize,p_100) 如果您有自己的技能包并发布到了github上,可以采用上述方式。 此处,我们以放置技能包到指定文件夹下的方式来进行安装,具体操作如下: 1.首先,解压之前下载的技能包,将解压文件放置到相应路径下,路径:C:\Users\{您的用户名}\.codex\skills 如图: ![](https://oss.showapi.com/doc/3989/22/f587f28110e8_1783826511077.png?x-oss-process=image/resize,p_100) 2.查看技能包安装情况,如果skill安装成功,可以在如下界面中看到,多了一个“文创设计”的技能: ![](https://oss.showapi.com/doc/3989/22/66a3a2fc4a97_1783826417407.png?x-oss-process=image/resize,p_100) ##三、使用技能 ###1.查阅技能(skill)参数 以文创设计工作流为例,地址: https://www.showapi.com/ai/promptflow/detail/6a4c58393c51f2d32d00c4fc?tab=test&sub=skill 在线测试界面如下: ![](https://oss.showapi.com/doc/3989/15/8685afc34067_1783490916113.png?x-oss-process=image/resize,p_100) 它包含了四个信息,分别是生成的产品图排版(1~4宫格图)、参考图(url或图片的base64字符串)、产品描述(提示词)、生成的产品图长宽比(默认1:1),其中第一个参数信息是必填项,其他参数可选。为确保生成的图片满足您的需求,建议您在软件中输入的提示词,要包含这四个参数,且尽可能详细的描述各个参数对应的信息。 ###2.调用skill的提示词 首先,点击左侧菜单中的“新对话”,在输入框下方选择“Skills”,然后在③出输入“/文创”,然后选择如图所示的技能包: ![](https://oss.showapi.com/doc/3989/22/22f143144ecc_1783826684205.png?x-oss-process=image/resize,p_100) 输入您的需求,也就是提示词,建议提示词中尽量包含测试界面中的所有参数。参考示例如下: `生成一个文化创意的产品宣传图,图片主要描述江浙一带的绸缎文化,图片为四宫格的图片,长宽比为16:9横版的, 产品参考图: https://oss.showapi.com/doc/4826/5/ae919726ce38_1780382555943.jpg ` * 这段提示词里,包含了四个参数的信息,分别是: 1> grid_num = 4、 2> image = https://oss.showapi.com/...82555943.jpg 3> prompt = 生成一个文化创意的产品宣传图,图片主要描述江浙一带的绸缎文化 4> aspect_ratio = 16:9 * ![](https://oss.showapi.com/doc/3989/22/52e466de651e_1783826734439.png?x-oss-process=image/resize,p_100) 如上图,填写好提示词,回车或点击右下角的发送按钮,开始调用skill。 如果出现下图中的“request timed out”,说明密钥配置不正确或者是"C:\Users\{你自己的用户名}\.codex\config.toml"文件配置被修改了,请重新配置。 ![](https://oss.showapi.com/doc/3989/22/3bd761669c3f_1783827210203.png?x-oss-process=image/resize,p_100) 我的config.toml配置参考如下(添加红框中的内容): ![](https://oss.showapi.com/doc/3989/22/1c9f33f2a1b8_1783827571051.png?x-oss-process=image/resize,p_100) ###3.调用过程及结果 注意:首次在调用skill,需要设置AppKey,后续调用该skill时就无需再配置了。登录万维易源官网后在此地址下可获取AppKey:https://www.showapi.com/console#/myApp; 在技能调用过程中,会不定时的在提示词输入框的位置处,或整个窗口界面,弹出窗口进行交互或确认,您根据实际情况进行操作。如网络请求权限的确认、文件操作的确认、调用所需密钥的调整、某些环境变量的更改等情况,会需要您的确认。交互的过程根据不同的skill,提示和操作的内容会完全不同,在此不做过多说明和展示,依据提示进行操作即可。 联网请求交互,点击"允许一次": ![](https://oss.showapi.com/doc/3989/22/c29628b2e962_1783827666770.png?x-oss-process=image/resize,p_100) AppKey设置的交互操作: 此时已经提示没有ShowAPI AppKey,准备切换到默认的图像生成skill或者模型,所以此处先点击右下角的执行按钮,以暂停执行,然后输入AppKey。 ![](https://oss.showapi.com/doc/3989/22/b7c2cc02a2a1_1783827865628.png?x-oss-process=image/resize,p_100) 调用的完整过程: ![](https://oss.showapi.com/doc/3989/22/9a38e8550964_1783828394215.jpg?x-oss-process=image/resize,p_100) 最终生成的结果图: ![](https://oss.showapi.com/doc/3989/22/beff0ab4d527_1783828287905.jpg?x-oss-process=image/resize,p_100) 我们使用的是ctmoai.com提供的模型代理功能,调用的模型GPT-5.5。 本次交互过程的花费如下,仅供参考,具体以实际发生的为准: ![](https://oss.showapi.com/doc/3989/22/c063c11a380a_1783828736828.jpg?x-oss-process=image/resize,p_100) ![](https://oss.showapi.com/doc/3989/22/4b2228b4540c_1783831333840.jpg?x-oss-process=image/resize,p_100)