生成范文

测试中，未正式开放

一句话说明

给定作文题目信息，先解析题目，再一次性生成多篇（默认 9 篇）不同立意的范文。
独立于作文批改：单独创建、单独回调；version_name 固定为 fanwen_v1。

发版说明：开放平台发版说明

你会得到什么

内容 说明
analysis 题目解析：写作要求、可选角度、选材建议
essays 范文列表：立意、标题、提纲、正文、字数等

创建后立即返回任务 ID；生成完成后回调推送（也可能需数十秒到几分钟）。

计费

约 1 次 / 0.2 元（标准版价位）。

怎么创建

  • 方法：POST
  • 地址：https://api.21days.cloud/opi/p/c012/generate_fanwen
  • Header：accessToken
字段 类型 默认 必填 说明
subject String 语文 否 语文 / 英语
grade String 四年级 否 年级
writing_type String 不限 否 文体
title / topic_content String '' 条件 至少一个非空
words_count Number 400 否 期望字数
correct_standard String '' 否 评分标准补充
count Number 9 否 生成篇数，范围 1~9
callback_url / is_dev — — 否 回调控制
transmission Object — 否 透传

查询详情

  • GET https://api.21days.cloud/opi/p/c012/fanwen/detail?zuowen_id=...
    参数使用创建返回的任务 ID。

回调重点字段

字段 说明
zuowen_id 任务 ID
version_name fanwen_v1
status 1 完成等
analysis.requirements 写作要求要点
analysis.angles 可写角度列表
analysis.materials 选材建议
essays[] 每篇含 angle / title / outline / content / words_count 等
transmission 透传原样返回

请求示例

1
2
3
4
5
6
7
8
9
{
  "subject": "语文",
  "grade": "五年级",
  "title": "那一次，我长大了",
  "topic_content": "写一件让你感到自己长大的事。",
  "words_count": 450,
  "count": 6,
  "callback_url": "https://partner.example.com/fanwen/callback"
}

对接检查清单

  1. 已确认开通 beta
  2. title / topic_content 至少一个有值
  3. count 在 1~9
  4. 回调按 fanwen_v1 解析，不要与批改结果混用字段假设
  5. 按 0.2 元 / 次预留余额

关联文档

主题 文档
发版说明 开放平台发版说明
鉴权 开放平台说明
接口索引 接口总览索引