文章创作API接口文档 GET / POST AI智能

专业文章生成AI的接口，可以生成各种类型的文章。

请求 GET / POST返回 application/json1 积分 / 次上线 2026-09-24 14:57:41

专业文章生成AI的接口，可以生成各种类型的文章。

1 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=writing
方法
GET / POST
分类
AI智能
计费
1 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

文章创作接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=writing
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=writing

apikey=你的API密钥&keyword=请填写keyword&type=请填写type&words=请填写words&extra_prompt=请填写extra_prompt&extra_sensitive=请填写extra_sensitive&format=请填写format

GET 参数放在查询字符串中。参数值请替换为实际有效值。

文章创作请求参数

参数名类型必填说明示例
keywordstring是关键词，支持多个（用换行 \n 或逗号 , 分隔）。系统会随机抽取其中一个进行创作。单个关键词长度 ≤ 50 字。
typestring否文章类型，默认知识科普。具体见接口详情。
wordsinteger否目标汉字字数，默认1000，范围 300 – 50000。超出范围将自动修正到边界值。
extra_promptstring否额外文章提示词，将追加到 AI 生成指令中（如：多举案例、语气幽默等）。
extra_sensitivestring否额外敏感词，多个用逗号分隔。文章中出现将替换为 *，不影响系统默认敏感词。
formatstring否返回内容格式： html — 仅返回富文本 HTML（字段 content_html）；text — 仅返回纯文本（字段 content_text 默认）；both — 同时返回两者

详细文档

文章创作 API 接口文档

接口描述

专业文章生成AI的接口，可以生成各种类型的文章。

功能特性

  • 专业文章生成AI的接口，可以生成各种类型的文章。
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=writing

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

  • URL 参数：key=SK-你的密钥
  • 或请求头：X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
keyword string 是 关键词，支持多个（用换行 \n 或逗号 , 分隔）。系统会随机抽取其中一个进行创作。单个关键词长度 ≤ 50 字。
type string 否 文章类型，默认知识科普。具体见接口详情。
words integer 否 目标汉字字数，默认1000，范围 300 – 50000。超出范围将自动修正到边界值。
extra_prompt string 否 额外文章提示词，将追加到 AI 生成指令中（如：多举案例、语气幽默等）。
extra_sensitive string 否 额外敏感词，多个用逗号分隔。文章中出现将替换为 *，不影响系统默认敏感词。
format string 否 返回内容格式： html — 仅返回富文本 HTML（字段 content_html）；text — 仅返回纯文本（字段 content_text 默认）；both — 同时返回两者

请求参数 (JSON格式)

[
  {"name": "keyword", "type": "string", "required": true, "description": "关键词，支持多个（用换行 \\n 或逗号 , 分隔）。系统会随机抽取其中一个进行创作。单个关键词长度 ≤ 50 字。"},
  {"name": "type", "type": "string", "required": false, "description": "文章类型，默认知识科普。具体见接口详情。"},
  {"name": "words", "type": "integer", "required": false, "description": "目标汉字字数，默认1000，范围 300 – 50000。超出范围将自动修正到边界值。"},
  {"name": "extra_prompt", "type": "string", "required": false, "description": "额外文章提示词，将追加到 AI 生成指令中（如：多举案例、语气幽默等）。"},
  {"name": "extra_sensitive", "type": "string", "required": false, "description": "额外敏感词，多个用逗号分隔。文章中出现将替换为 *，不影响系统默认敏感词。"},
  {"name": "format", "type": "string", "required": false, "description": "返回内容格式： html — 仅返回富文本 HTML（字段 content_html）；text — 仅返回纯文本（字段 content_text 默认）；both — 同时返回两者"}
]

响应格式

JSON 格式响应

返回参数说明

参数名 类型 说明
success string 请求是否成功，成功为 true
data string 返回数据对象，成功时存在
data.keyword string 实际抽中的关键词
data.title string 生成的标题（7 – 50 字）
data.type string 使用的文章类型
data.target_words string 目标字数
data.char_count string 实际汉字字数
data.content_html string 富文本 HTML 内容（format=html 或 both 时返回）
data.content_text string 纯文本内容（format=text 或 both 时返回）
data.usage string Token 用量统计对象
data.usage.prompt_tokens string 输入消耗的 token 数（标题 + 文章累加）
data.usage.completion_tokens string 输出消耗的 token 数
data.usage.total_tokens string 总 token 数
data.generated_at string 生成时间，格式 Y-m-d H:i:s
data.execution_time string 本次请求总耗时（秒）

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=writing?key=SK-你的密钥&keyword=%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD&words=300"

错误响应

上游业务级错误：

code msg 描述
400 missing_keyword 未提供关键词参数 keyword
sensitive_content 关键词包含敏感词被拦截
500 generation_failed 文章生成失败（AI 服务异常、内容敏感等）

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
  • 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
  • 请合理控制调用频率，避免高频恶意调用触发风控
  • 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24