1 实验内容

API Arts是一个面向开发者，提供了API设计、API开发、API调试、API自动化测试等功能的一体化协作平台。通过维护API各开发阶段数据高度一致，支持开发者高效实现API全生命周期的管理。

API Explorer为开发者提供一站式API解决方案统一平台，集成华为云服务所有开放API，支持全量快速检索、可视化调试、帮助文档、代码示例等能力，帮助开发者快速查找、学习API和使用API开发代码。

本实验基于华为云的API Arts和API Explorer，向用户介绍诗歌生成API，指导用户使用华为云工具，体验AI作诗的过程。

2 注意事项

• 用户需要申请华为云账号并通过实名认证才能进行体验
• 部分工具需要付费，需要申领代金券才能体验

3 提前准备

• 请注册华为云账号并完成实名认证，实验过程中请使用Chrome浏览器完成相关操作。

• 华为云账号注册步骤请参考：

https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0069252244.html

• 实名认证操作步骤请参考：

https://support.huaweicloud.com/usermanual-account/account_auth_00001.html

• 代金券申领指导

1. 登录华为云并完成实名认证（http://su.modelarts.club/h4Zu）
2. 加入沃土云创个人计划：

https://developer.huaweicloud.com/programs/dev-program.html

1. 第一步：选择界面上的“个人”，点击“立即加入”
2. 第二步：如实填写以下带红色“*”的必填项，并勾选承诺和须知。

     c.第三步：点击“提交”后，即显示已成功加入。

     d.第四步：在原页面点击左侧“激励管理”—“计划权益”，找到右侧“学习代金券(云服务)”，点击“申请”

   e.第五步：点击弹窗的“确认”，即显示申请成功

 3.查看申领的代金券

以上代金券一旦申请成功，即时生效，无需激活。点击链接，查看代金券额度和有效期（http://su.modelarts.club/nWsu）

• 调用诗歌生成服务前，需要开通自然语言定制版API“诗歌生成”服务：https://console.huaweicloud.com/nlp/#/nlp/overview

1. 第一步，打开链接，确认左上角区域选择北京四
2. 第二步，找到定制版API分类
3. 第三步，选择诗歌生成服务，点击右侧的开通服务，并在弹窗中点击确定

注：诗歌生成接口是定制版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调试记录，也可以获取历史请求的结果，不用担心自己喜欢的诗句没有保存，完成调试记得截图保持生产的诗歌作品，以便后续提交评选。