9 个AI提示词接口，让「写小说」变成API调用的完整方案

一、为什么要用 API 写小说？

传统内容生产线：

需求 → 产品 PRD → 编剧 → 美术 → 视频 → 运营 → 发布

平均耗时 30 天。
在 Explinks Prompt 架构下：

需求 → 一次 HTTP 调用 → 同步返回正文+插画+短片+Slogan

耗时 ≤ 10 min，且全部走标准 JSON，可嵌入 CI/CD，实现「版本化内容」。

二、接口拓扑与调用时序

每条 Prompt 均为无状态服务，可并发，可缓存，可熔断。

三、核心接口清单（9 组）

功能	提示词名称	Method & Path	请求示例字段	返回格式
1. 角色命名	小说角色命名生成	POST /novel/naming	`{"gender":"M","trait":"cold","weapon":"sword"}`	`{"names":["顾长夜","苏忘尘"]}`
2. 章节正文	小说章节创作	POST /novel/chapter	`{"keywords":["石碑","0→999","群嘲"],"words":2000}`	`{"chapter":"...<正文>","hook":"..."}`
3. 插画生成	小说核心插画	POST /novel/illustration	`{"scene":"石碑前少年","style":"fantasy"}`	`{"url":"<4K.png>","thumb":"<512.png>"}`
4. 动态短片	小说章节预告短片	POST /novel/teaser	`{"scene":"石碑冲击","aspect":"9:16"}`	`{"mp4":"<cdn_url>","duration":15}`
5. 宣传语	书籍或小说宣传语创作	POST /novel/tagline	`{"theme":"送人修为+30天","count":10}`	`{"lines":[...]}`
6. 策略大纲	小说创作策略指南	POST /novel/outline	`{"genre":"xianxia","theme":"逆袭"}`	`{"acts":[...],"beats":[...]}`
7. 续写服务	小说续写助手	POST /novel/continue	`{"lastPara":"...","words":1000}`	`{"continuation":"..."}`
8. 对白视频	小说人物对白视频化	POST /novel/dialogue-video	`{"dialogue":[...],"background":"tavern"}`	`{"mp4":"<cdn_url>"}`
9. 叙事插图	故事情节叙事插图	POST /novel/narrative-art	`{"plot":"雨中离别","emotion":"sad"}`	`{"url":"<webp>"}`

所有接口统一返回：

{
  "code": 200,
  "msg": "success",
  "data": { ... }
}

失败则返回标准 HTTP 状态码及 code 非 200，便于网关统一熔断。

四、SDK 快速接入（Python 示例）

pip install explinks-novel-sdk

from explinks_novel import NovelClient

client = NovelClient(api_key="YOUR_API_KEY")

# 1. 获取角色名
names = client.naming(gender="M", trait="cold", weapon="sword")
print(names)  # ['顾长夜', '苏忘尘']

# 2. 生产章节
chapter = client.chapter(keywords=["石碑", "0→999", "群嘲"], words=2000)
print(chapter.text)  # 2000 字正文
print(chapter.hook)  # 章尾钩子

# 3. 同步插画
illu = client.illustration(scene="石碑前少年", style="fantasy")
print(illu.url)  # 4K 封面地址

# 4. 一键打包
pkg = client.pipeline(keywords=["石碑", "0→999"], words=2000, aspect="9:16")
# pkg.chapter / pkg.illustration / pkg.teaser / pkg.taglines

SDK 默认异步回调，支持 asyncio；缓存策略：相同请求 5min 内直接返回 CDN 地址，降低 token 成本。

五、性能与容错

指标	数值
平均响应	1.2 s
P99 延迟	3.5 s
缓存命中率	78%
熔断阈值	连续 3 次 5xx 或 >10s

提示词池采用多副本部署，任一 Pod 崩溃不影响整体 SLA；插画/视频走 CDN，全球边缘节点 <200 ms。

六、计费与限流

按次计费，HTTP 状态码 = 200 才计入；
插画/视频额外收取 GPU 渲染费，单价见官网价目表；
默认 QPS=10，提工单可升至 1000；
失败重试不计费，但需遵守退避算法（Exponential Backoff）。

七、最佳实践：用 Git 管理内容版本

$ git clone <your-content-repo>
$ echo "KEYWORDS=石碑,0→999" > .env
$ make novel-chapter
$ git add chapter.md illustration.png teaser.mp4
$ git commit -m "feat: ch01 石碑反转上线"
$ git push origin main

CI 自动调用小说章节创作与小说核心插画，实现「提交即发布」。

八、常见问题（FAQ）

Q1 是否支持 GraphQL？
A：预计 2025 Q3 放出 /graphql 端点，现阶段请使用 REST。

Q2 能否私有化部署？
A：提供 on-premise 镜像，需 GPU 节点 ≥ 4 卡 A10，联系商务获取许可证。

Q3 失败重试策略？
A：官方 SDK 已实现指数退避，最大 3 次；超出请捕获异常并降级。

九、下一步 Roadmap

2025 Q4：开放小说动态场景短片 WebSocket 流式输出，支持「边生成边下载」
2026 Q1：支持故事情节叙事插图批量并发，最大 50 张/次
2026 Q2：提供 Java、Go、Rust 多语言 SDK，纳入 Cloud Native 生态

十、一键体验 & 接入文档

登录控制台：https://console.explinks.com
创建 NOVEL_API_KEY
复制上方 Python 代码，即可在本地跑通第一条「角色命名」调用

Now, write your first line of code —— and the first chapter of your novel.