API 配置指南 · 与星同行

这套 API 是什么

游戏本身不提供 AI 算力：剧情正文、角色记忆、社交媒体动态、状态栏解析，全部由你绑定的模型服务商（如 DeepSeek、Gemini）生成。你在设置里填入自己的 API Key，费用直接结算给你选择的模型厂商，与游戏无关。

好消息是：这些服务商大多提供免费额度或极低价模型（Gemini、GLM 都有免费档），一个月日常游玩的开销通常只有几块钱。

四个 API 槽位

设置面板里有四个独立槽位，各管一块职责。它们可以填同一个 Key，也可以分别用不同服务商。

槽位	职责	默认模型	推荐温度	能否省略
叙事 API	剧情正文生成，整个游戏的核心	deepseek-v4-flash 推荐升级 PRO	0.9	不能，必填
记忆 API	长期记忆的提取、回顾与合并	deepseek-v4-flash	0.3	可省略，回退到叙事
社媒 API	微博、热搜、社交动态等外围内容	deepseek-v4-flash	0.8	可省略，回退到叙事
状态栏 API	状态 JSON、时间解析、世界书生成等轻量调用	deepseek-v4-flash	0.7	可省略，回退到叙事

只填一个也能玩

记忆、社媒、状态栏三个槽位留空时，会自动复用叙事 API 的配置（Key、地址、模型）。也就是说：最少只需要一份 API Key 就能完整游玩。

flowchart TD
  A[叙事 API
必填] -->|生成正文| G[游戏剧情]
  M[记忆 API] -->|未配置时回退| A
  S[社媒 API] -->|未配置时回退| A
  T[状态栏 API] -->|未配置时回退| A
  M -->|独立配置| G
  S -->|独立配置| G
  T -->|独立配置| G

四个槽位与回退机制：未配置的槽位自动复用叙事 API

三分钟完成第一次配置

进入设置：打开游戏，点击右上角菜单，进入「设置」面板，找到 API 配置区。
选服务商预设：点服务商下拉，选择 DeepSeek / Gemini / OpenAI / OpenRouter / GLM 中的任意一个，地址和模型名会自动填好。
粘贴 API Key：把你从服务商官网申请的 Key 粘贴到「叙事 API」的 Key 输入框。其他三个槽位先留空（自动回退）。
测试连接：点击「测试连接」，看到成功提示说明配置可用。
保存并开始：点击保存，回到对话页发送第一条消息即可。

提示：如果测试失败，优先检查三件事——Key 是否复制完整、账号是否已充值/开通、服务商是否临时故障。换一个服务商预设再试通常就能定位问题。

各家 Key 去哪领

服务商	预设地址	预设模型	Key 获取	特点
DeepSeek	api.deepseek.com	deepseek-v4-flash 叙事可选 v4-pro	platform.deepseek.com	中文叙事强、便宜，国内直连
Gemini	generativelanguage.googleapis.com/v1beta/openai	gemini-2.5-flash	aistudio.google.com	有免费档，长文本强
OpenAI	api.openai.com	gpt-4o	platform.openai.com	效果稳，需境外支付
OpenRouter	openrouter.ai/api	google/gemini-2.5-flash	openrouter.ai	一个 Key 用几十种模型
GLM	open.bigmodel.cn/api/paas/v4	glm-4-flash	open.bigmodel.cn	flash 档免费，适合记忆/状态栏

模型怎么选：叙事上 PRO，其他用 flash

DeepSeek 现在的模型代号是 deepseek-v4-flash（便宜、速度快、日常够用）和 deepseek-v4-pro（质量更高、贵一些）。正文叙事推荐用 PRO，剧情质感提升明显；记忆、社媒、状态栏这类轻量任务全部推荐 flash，省钱且完全够用。老版本模型代号 deepseek-chat 已作废，配置时会自动迁移到 v4-flash。

最省事：一份 Key 走天下

只填叙事 API，其余三个槽位全留空。所有调用都走同一个模型，配置零思考，适合新手。想要更好的正文效果，就把叙事模型填成 deepseek-v4-pro。

最省钱：贵的写正文，便宜的干杂活

正文用 deepseek-v4-pro（叙事质量优先）；记忆、社媒、状态栏填 deepseek-v4-flash 或直接留空回退；也可以把轻量任务换成 GLM flash 免费档、Gemini 免费档。一局下来成本能压到几分钱。

效果优先：正文用强模型

正文用 OpenAI 或 Gemini 的高规格模型，记忆/社媒/状态栏用便宜档。四个槽位互相独立，不会互相拖慢。

联网搜索 API

联网搜索让 AI 能获取实时信息（真实热搜、新闻、时事梗），避免凭空编造。搜索使用 Tavily 的搜索接口，在 tavily.com 注册即可免费获取 API Key（每月约 1000 次额度）。

配置项	说明
搜索 API Key	Tavily Key，填在设置 → 搜索区的 Key 输入框
搜索模式	前置（先搜后写，实时信息进正文）／精准（搜索 + 事实校验，防编造，消耗最高）／后置（写完后搜索校准）
快捷开关	聊天输入框旁的「联网」开关，本轮开启、发送后自动关闭

精准模式的使用建议

建议默认使用精准模式，它是三种模式里防编造最可靠的——先生成内容，再用实时搜索结果逐条校验，确保提到的事实（人名、事件、数据）真实可信。但精准模式要同时跑生成和搜索校验，消耗会大幅提高，因此请在确实需要准确实时信息时才开启：例如剧情涉及真实新闻、当下热点、具体人物资料时；日常闲聊式剧情可以不开搜索，省钱也更快。

搜索还用在别处：遇到新女星时，系统会自动联网抓取她的真实公开资料生成人物档案，同样消耗 Tavily 额度。

常见问题

测试连接一直失败怎么办

先确认 Key 无多余空格、账号已开通对应模型；再切换另一个服务商预设试试；仍失败就检查网络环境能否访问该服务商（部分境外服务商需要代理）。

我的 Key 会被游戏或别人看到吗

不会。Key 只保存在你自己的浏览器本地，登录账号后加密同步到你自己的云端设置，任何接口都不会明文返回给他人。不同账号、游客之间完全隔离。

正文总被截断 / 字数不够

叙事槽位的最大输出已默认提升到 8192 token，旧配置会自动迁移。若仍不足，可在高级设置里调大 maxTokens，或降低正文字数要求。

高级设置里的自定义请求头是什么

面向进阶用户：可以以 JSON 形式附加请求头（如 {"X-Custom-Header":"value"}）和额外请求参数（如 {"top_p":0.9}），一般玩家无需改动。