在 Novelmint 发布作品

发布 API 接受完整稿件并将其呈现给读者。合作伙伴创建书籍,逐章上传,附上封面后发布。以下所有规则决定最后一步能否成功,因此在编写任何相关代码之前,建议仔细阅读。

不可在此发布的内容

以下两类内容在发布时将被拒绝,无论提交者是谁,也无论其与作者之间存在何种协议。

  • 成人内容。被归类为成人内容的作品仅限稿件模式。此类作品可以创建、编辑和导出,但不能上架销售。分类按章节判定并汇总至整部书,因此单个章节即可导致整部作品无法发布。
  • 同人小说。基于他人角色创作的作品在另一维度上同样仅限稿件模式,平台不能作为其发行渠道。这是版权问题,与作品质量无关,即便作者对其自身文本拥有一切可能的权利,该规定仍然适用。

两类情况均通过发布调用返回机器可读的原因码(manuscript_onlyfan_fiction_manuscript_only),因此数百部作品的目录无需逐一阅读英文说明即可完成核对。第三个原因码 derivative_unresolved 表示内容审核标记了可能属于其他作品的角色,需由作者解决后方可上线。

作品归属

以作者名义发布的书籍归作者所有。其账户拥有系列所有权,读者关注的是作者本人,收益也归作者所有。即便日后与合作伙伴的合作关系终止,这一点也不会改变,且合作伙伴无法对此进行任何配置。

以自有品牌发布的合作伙伴以通常方式拥有其书籍。两种模式在创建书籍时按册选择,以下授权机制仅适用于第一种模式。

收益分配方式

  • 读者按章付费,作者保留所得的 70%。
  • Novelmint 保留 30%。
  • 合作伙伴对其带来的每部作品享有 10% 的推荐分成,该分成来自 Novelmint 的 30%,永远不会从作者的 70% 中扣除。接受合作伙伴对作者毫无成本。

10% 分成按书自动计算,这意味着同一位作者可以带来来自多个合作伙伴的书籍,每个合作伙伴仅对其实际带来的作品获得分成。无需签署任何协议,也无需进行任何配置。

收益分成协议是另一种机制,它从作者自身 70% 中提取份额,需经作者协商并反签,不属于 API 范畴。如有需要,须人工另行安排。

合作伙伴收益的持有与支付条款与个人作者相同,没有单独的合作伙伴结算安排。

授权及其用途

合作伙伴声称已获得作者授权,仅是合作伙伴的一面之词。平台不会仅凭此发布他人书籍,因此以作者名义提交的作品会被接收后暂时搁置:完整上传、完全不可见、等待确认。

作者本人授权有以下四种方式。

  • 直接跳转。作者在合作伙伴平台点击按钮,跳转至此在自己的会话中确认,随后返回。这是最快、最有力的方式,因为确认由作者亲自完成,而非由他人代为声明。
  • 后台确认。已有账户的作者在其发布页面接受授权,无需邮件参与。
  • 认领链接。尚无账户的作者将收到一封邮件,说明已提交的内容,并请其选择接受或拒绝。
  • 作者主动申请。作者可主动请求已上架的合作伙伴为其发布,这是授权而非指令:合作伙伴仍须自行提交,作者的请求不凌驾于双方之间的任何合同约定。

作者接受后,在该授权下搁置的所有内容将按合作伙伴已声明的条款一次性发布,所有权同时转移给作者。此后授权持续有效,后续作品将即时发布。每次发布时,作者都会收到邮件通知。

撤销授权

作者可随时在其发布页面撤销授权。撤销后,合作伙伴将无法继续提交新作品,但已上线内容不受影响,合作伙伴对已带来作品的 10% 分成也不受影响——该分成记录的是谁带来了这部书,而非谁当前有权提交更多内容。

清除现有作品的归属标记是可能的,但须以作者书面申请为准。此操作人工处理,且仅向前生效:已支付的收益不会被追溯修改。

作者也可以选择拒绝并屏蔽,阻止合作伙伴再次联系。被屏蔽作者的邮箱地址仅为此目的保留。

版本管理及我们承诺不会破坏的内容

版本号体现在路径中:/api/publish/v1/。每个响应也会携带 Novelmint-Publish-Version 请求头。

在 v1 版本内,我们可能会新增端点、可选请求字段、响应字段和新错误码。您的集成需忽略所有未知字段——正是这一条要求使 v1 能够持续改进而不影响您的集成。

删除字段、重命名字段、更改字段类型,或改变现有值的含义,将升级为 v2 并使用新路径。v1 将持续提供服务,任何退役计划都将提前以书面形式通知,而非仅凭版本号变更暗示。

实际限制

  • 章节逐章上传,每章最大 1 MB,不支持整书上传端点。
  • 上传免费,此流程不消耗任何积分。
  • 封面通过发布调用时提供的 HTTPS URL 获取,审核在发布后进行,而非发布前。
  • 测试令牌会运行完整流程,但在发布前停止,因此集成可以端到端测试,而不会有真实作品触达读者。
  • 每个响应都会回显合作伙伴自身的目录引用,且每次写入均为幂等操作,因此重试批处理不会产生重复数据。

获取令牌

发布合作伙伴须经人工审核。审核通过后,可在合作伙伴后台的"令牌"标签页生成令牌。完整端点参考文档已公开,点此查看申请成为合作伙伴,或查看已在此发布的合作伙伴