摘要：本实验基于华为云API Arts和API Explorer，向用户介绍诗歌生成API，指导用户使用华为云工具，体验AI作诗的过程。
本文分享自华为云社区《AI语言能力体验：通过三种不同的工具体验AI作诗》，作者： 华为云PaaS服务小智。
1 实验内容
API Arts是一个面向开发者，提供了API设计、API开发、API调试、API自动化测试等功能的一体化协作平台。通过维护API各开发阶段数据高度一致，支持开发者高效实现API全生命周期的管理。
API Explorer为开发者提供一站式API解决方案统一平台，集成华为云服务所有开放API，支持全量快速检索、可视化调试、帮助文档、代码示例等能力，帮助开发者快速查找、学习API和使用API开发代码。
本实验基于华为云API Arts和API Explorer，向用户介绍诗歌生成API，指导用户使用华为云工具，体验AI作诗的过程。
2 注意事项
- 用户需要申请华为云账号并通过实名认证才能进行体验
- 部分工具需要付费，需要申领代金券才能体验
3 提前准备
- 请注册华为云账号并完成实名认证，实验过程中请使用Chrome浏览器完成相关操作。
- 代金券申领指导
- 登录华为云并完成实名认证（http://su.modelarts.club/h4Zu）
- 加入沃土云创个人计划：https://developer.huaweicloud.com/programs/dev-program.html
第一步：选择界面上的“个人”，点击“立即加入”
第二步：如实填写以下带红色“*”的必填项，并勾选承诺和须知。
第三步：点击“提交”后，即显示已成功加入。
第四步：在原页面点击左侧“激励管理”—“计划权益”，找到右侧“学习代金券(云服务)”，点击“申请”
第五步：点击弹窗的“确认”，即显示申请成功
3.查看申领的代金券
以上代金券一旦申请成功，即时生效，无需激活。点击链接，查看代金券额度和有效期（http://su.modelarts.club/nWsu）
- 调用诗歌生成服务前，需要开通自然语言定制版API“诗歌生成”服务：https://console.huaweicloud.com/nlp/#/nlp/overview
- 第一步，打开链接，确认左上角区域选择北京四
- 第二步，找到定制版API分类
- 第三步，选择诗歌生成服务，点击右侧的开通服务，并在弹窗中点击确定
注：诗歌生成接口是定制版API，是按需收费，可以通过申领的代金券来抵扣。
4 实验步骤
4.1诗歌设计（API Arts部分）：
1）进入API Arts并登录https://console.huaweicloud.com/apiarts/?region=cn-north-4#/home
2）点击首页右上角的创建项目按钮
3）在新建弹窗内输入“诗歌生成”，点击确定
4）新建成功之后，界面会自动跳转到项目详情页面，点击“新建API接口”卡片
5） 点击POST方法，可以修改接口方法，选择“POST”
6）输入接口地址“/poem”
7）输入接口名称“诗歌生成”
4.2诗歌生成（API Explorer部分）：
1）登录API Explorer诗歌生成API调试界面，输入标题和类型即可进行调试：https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=NLP&api=RunPoem
注：调试前要确保代金券已申领，同时已经开通自然语言定制版API“诗歌生成”服务，详情见“提前准备”章节。
2）以“今天”为主题进行诗歌生成为例，根据Type类型的不同支持五言绝句、七言绝句、五言律诗、七言律诗等类型的诗歌生成：
3）相同的title标题，会生成不同的诗句，用户可以调用多次（建议5次以上）并从中挑选一首自己最喜欢的诗句：
4）Acrostic选择True，支持藏头诗的生成：
5）查看API调试历史：
页面左侧菜单中“调试历史”可以看到调试的历史记录，也可以直接通过链接打开：https://apiexplorer.developer.huaweicloud.com/apiexplorer/historys
在调试历史中，可以看到诗歌生成的API调试记录，也可以获取历史请求的结果，不用担心自己喜欢的诗句没有保存，完成调试记得截图保持生产的诗歌作品，以便后续提交评选。
