主题诗歌创作

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

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

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

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

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

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

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

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

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

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

生成内容建议人工审阅，不保证作品唯一性或特定格律。

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

请求字段：topic 为去除首尾空白后 1～200 个 Unicode 字符；streaming 默认 false。支持 JSON 或表单 Body。
AppKey 可通过 Body/Query appkey、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 或 Bearer 传递；同值可共存，冲突返回 501。

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 事件返回。

返回 Data.title、Data.content；DataStatus 保持五个字段，DataTotalCount 成功为 1、失败为 0。正式请求摘要仅显示主题长度和模式，固定 Demo 显示完整公开主题。

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "topicLength=6&streaming=false",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-09-07 02:14:17.916",
    "DataTotalCount": 1
  },
  "Data": {
    "title": "橄榄枝下的微光",
    "content": "当硝烟散尽于晨曦的指尖，\n废墟之上，野花悄然绽放。\n不再有需要擦拭的枪膛，\n只有风，轻抚过愈合的土壤。\n\n爱不是高声的宣言，\n而是静默中紧握的双手，\n跨越国界，穿透迷雾，\n在彼此眼中看见温柔的宇宙。\n\n让鸽子衔来绿色的信笺，\n写给每一个渴望安宁的灵魂，\n和平是心底最柔软的防线，\n爱是永恒不灭的星辰。"
  }
}

请求参数

请求示例代码

返回响应