摘要：本實驗基於華為雲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除錯記錄，也可以獲取歷史請求的結果，不用擔心自己喜歡的詩句沒有儲存，完成除錯記得截圖保持生產的詩歌作品，以便後續提交評選。