主题诗歌创作

按主题生成诗歌标题与正文。

输入主题，生成对应的诗歌标题与正文；

支持围绕自然、情感、节日等主题创作；

可在主题中描述希望表达的意境与情绪；

支持中文、英文等语言主题输入；

可在主题中说明希望使用的创作语言；

单次主题支持最长 200 个字符；

正文保留分行，便于阅读、展示与编辑；

支持一次性返回或流式接收创作结果；

适合创作启发、文学教学、祝福与活动文案；

生成内容建议人工审阅，不保证作品唯一性或特定格律。
支持 JSON 或表单 Body；topic 去除首尾空白后为 1～200 个 Unicode 字符。AppKey 支持 Body、Query、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 和 Bearer；相同值可共存，冲突返回 501，缺失返回 504。拒绝未知或重复业务参数。
streaming=true 时返回 text/event-stream。content.text 是 JSON 文本片段，不是纯诗歌。按顺序拼接全部 text，结果必须等于 done.full_text；对 full_text 执行 JSON.parse 后获得 title/content。仅收到合法 done 后及 event: end / data: [DONE] 才算完整成功。event: error 的 data 为含 error 字符串的对象；收到错误或断流时不得把已收到片段当作完整结果。开始流式响应前的错误使用标准 JSON 和 HTTP 状态；开始之后的错误通过 error 事件返回。

当前接口契约

接口详情：https://www.gugudata.com/api/details/poet-writing

请求参数

参数	类型	必填	默认值	说明
topic	string	是	无	Body 中的主题，去除首尾空白后为 1～200 个 Unicode 字符。 AppKey 支持 Body/Query appkey、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 和 Bearer；同值可共存，冲突返回 501，缺失或无效返回 504。
streaming	boolean	否	false	默认 false；JSON 为布尔值，Query/Form 仅 true/false。同值可共存，冲突返回 501。流式 content.text 为 JSON 文本片段，拼接后等于 done.full_text；解析 full_text 得到 title/content。
appkey	string	否	无	也可通过请求头或 Query 提供。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	成功结果对象数量：成功 1，失败 0。
Data.title	string	生成的诗歌标题
Data.content	string	生成的诗歌内容

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数或凭证冲突	HTTP 400
502	请求频率受限	HTTP 429
503	订单到期	HTTP 403
504	AppKey 缺失或无效	HTTP 401
505	额度耗尽	HTTP 403
900	内部错误	HTTP 500
901	诗歌创作暂时不可用	HTTP 503

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"{\"topic\":\"关于和平与爱\",\"streaming\":false}","StatusCode":100,"StatusDescription":"请求成功。","ResponseDateTime":"2026-10-26 06:22:16.986","DataTotalCount":1},"Data":{"title":"橄榄枝下的低语","content":"当硝烟散尽于晨曦的微光，\n废墟之上开出温柔的花。\n不再有声嘶力竭的呐喊，\n只有风穿过树梢的沙沙。\n\n爱是缝合裂痕的金线，\n在破碎的心田间静静流淌。\n它不问过往的恩怨深浅，\n只愿此刻，彼此目光安详。\n\n让我们放下紧握的拳头，\n去触碰另一只颤抖的手掌。\n和平不是沉默的妥协，\n而是灵魂深处共鸣的回响。"}}

🟠400参数或凭证冲突（业务码 501）。

🟠401AppKey 缺失或无效（业务码 504）。

🟠403订单到期（业务码 503）；额度耗尽（业务码 505）。

🟠429请求频率受限（业务码 502）。

🔴500内部错误（业务码 900）。

🔴503诗歌创作暂时不可用（业务码 901）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明