返回教程列表

Yuyanjia API Guide

预言家API站指南

按步骤完成购买、充值、密钥填写和模型选择。

目录

方案一:直购密钥

购买地址:https://shop.yuyanjia.top/

分类切换至【API密钥】,选择自己想要的额度

回到我们的 APP,点击设置齿轮。

点击【保存设置】

OK,大功告成,现在就可以去聊天了!

🔎 密钥余额查询

如果想确认直购密钥的额度是否到账,或之后想看剩余额度,可以打开 密钥余额查询,粘贴刚才复制的 sk- 密钥查看。

方案二:注册账号,充值额度

一、注册

点击链接注册:

二、充值

注册完成后,点击菜单的 【控制台】 →左侧菜单栏 【钱包管理】。

方式一:支付宝直充

如果你想省去购买兑换码的步骤,可以直接在钱包管理里选择充值金额,付款方式选择【支付宝当面付】。

支付宝直充会收取 0.6% 手续费,例如充值 10 元,需要支付 10.06 元。支付成功后额度会直接进入账号余额,不需要兑换码,也不会生成兑换码订单。

方式二:购买兑换码

点击【购买兑换码】

分类切换至【API站充值】

获得卡密后,回到api站,兑换额度即可

三、锻造密钥(API KEY)

点击菜单的 【控制台】 →左侧菜单栏 【令牌管理】 → 【添加令牌】。

点击红框图标,可以直接复制你的密钥

四、APP 注入能量

回到我们的 APP,点击设置齿轮。

点击【保存设置】

新手补课 · 老手可跳过

🪄 什么是 API?

预言家 TV 的文游需要 AI 大模型帮你续写剧情。你可以把提供 AI 服务的平台想成一家“魔法公司”,而 APP 就像替你送信的猫头鹰。

↑ 返回购买方式
Base URL · 地址

公司的办公地址

告诉猫头鹰应该去哪里送信。

API Key · 密钥

公司的通行证

证明平台允许你使用它的服务。

Model · 模型

负责回信的员工

比如 Gemini、Claude、DeepSeek。

魔法生效公式 地址 + 钥匙 + 员工 = 顺利回信

三样东西必须来自互相匹配的平台,少一样或填错一样都不行。

01

钥匙不是自己编的密码

API Key 必须由你准备使用的平台生成。可以去对应平台注册账号后创建,也可以从它提供的正规渠道购买现成密钥;从哪家拿到密钥,就使用哪家给出的地址和模型。

密钥和银行卡密码差不多重要:复制时一个字符都不能少,也不要发给陌生人或放进公开截图。

02

别把钥匙插错门

拿到 A 平台的密钥,就要填写 A 平台的 Base URL。拿着 B 公司的钥匙去开 A 公司的门,密钥本身没错也不会有反应。

03

别叫错员工的“工号”

中转站为了区分渠道,模型名称通常会带上 [cli][满血] 之类的前缀。手动复制时必须连同括号一起复制完整,少一个符号都可能找不到模型。

还是用不了?

按顺序检查:地址是否完整 → 密钥是否完整 → 模型是否来自正确的平台。 多数 API 问题都藏在这三处。

看懂了,返回购买方式 ↑

🧠 模型选择建议

为了保证大家的体验,站内所有模型我都亲自测试筛选过。

没有完美的模型,只有最适合当下的。 如果遇到报错,请灵活切换备用渠道!

📝 站长碎碎念(必看!)

01
关于备货

先充十块试用

API 站有香港主站和北京备用两个入口。大部分人先用主站;个别地区网络抽风,再切备用。

觉得稳、用得顺手以后再慢慢充,别一上来就囤太多。
02
关于速度

主站优先,备用兜底

入口拆成两种走法,是为了让不同地区都有能用的选择。大部分时候比较顺畅,但当地网络情况没法完全保证。

老规矩:先试用,再囤货。
03
关于模型状态

降智和“掺水”不是一回事

一次回复变差,不能直接判定被换了模型

从玩家体感来说,新模型刚发布的第一周往往最聪明。之后随着使用人数变多、算力分散,服务端资料和策略也持续调整,表现可能慢慢回落。大家说的“资料库污染”,就是在形容资料和反馈混入噪声后,模型越来越爱写八股文、套固定模板的感觉。

发布首周通常最惊艳资源相对集中,模型的新鲜感最强
每天高峰可能临时变笨同时使用的人太多,算力被摊开
换代之前旧模型容易波动格式、记忆和文风问题会更明显
常见表现
  • 原本守得好好的格式突然疯狂掉
  • 不读人物卡和世界书,前后设定对不上
  • 反复使用同一套句子,八股味越来越重
  • 上下文接不住,甚至开始胡言乱语

可以换个时间、重新开一段对话,或切备用渠道对比。别只凭一次回复就急着下结论。

降智 还是原来的员工,只是状态变差

可能是当天太忙、算力紧张,或者公司调整了它的工作方式。

掺水 标牌没变,背后却长期换了员工

例如换成别的模型,或把不同模型混在一起轮流回信。

04
关于售后

驴不是 24 小时客服团队

本杰驴的站子看起来花里胡哨,是因为驴在成为文游打工人之前做的是品牌策划。预言家 TV 旗下的游戏和网站,都是驴一个人在运营维护,并没有成熟的商业化团队。

群里的管理员也是为爱发电的老玩家,没有后台权限,更不是 24 小时在线的专业客服。大家可以这样分工:

先问老玩家 基础配置问题

Base URL 怎么填、密钥放哪里、怎么拉取模型,可以先看教程或在群里求助。

直接找本杰驴 充值、退款和疑难报错

充值没到账、退款、异常扣费、反复报错等问题,管理员没有权限处理。

来找驴时请带上报错截图 · 发生时间 · 模型完整名称 · 使用渠道

完整 API Key 不要发在群里,先把自己的魔法钥匙收好。🫡