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

耗時 ≤ 10 min，且全部走標準 JSON，可嵌入 CI/CD，實現「版本化內容」。

二、接口拓撲與調用時序

每條 Prompt 均為無狀態服務，可并發，可緩存，可熔斷。

三、核心接口清單（9 組）

所有接口統一返回：

{
  "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 成本。

五、性能與容錯

提示詞池采用多副本部署，任一 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 生態

十、一鍵體驗 & 接入文檔

1. 登錄控制臺：https://console.explinks.com
2. 創建 NOVEL_API_KEY
3. 復制上方 Python 代碼，即可在本地跑通第一條「角色命名」調用

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