如果你是第一次接 md2wechat API,最容易卡住的是:
我该拿哪一类 key?又该去哪里申请?
这篇文章就只讲这件事。
先认清 3 类 key
当前有 3 类前缀:
wme_wme2_wmt_
它们对应不同用途。
wme_
这是旧正式 key。
它主要是为了兼容已有接入,不建议你作为新接入的默认选择。
wme2_
这是新正式 key。
如果你现在是第一次接,或者准备正式接到自己系统里,优先申请这一类。
wmt_
这是试用 key。
它适合:
- 临时测试
- 演示环境
- 开发者先验证接口是否适合自己
但它不是给长期正式接入准备的。
正式 key 和试用 key 的区别
先说最重要的一点:
- 试用 key 是为了先体验,不是为了长期白用
- 正式 key 才适合接进正式工作流
什么时候该申请正式 key?
你符合下面任意一种情况,就建议直接走正式 key:
- 已经准备接自己的产品
- 会持续调用接口
- 需要稳定发布或稳定转换
- 要把它接进 Agent、服务端或自动化流程
什么时候适合先拿试用 key?
如果你现在只是想确认:
- 这个接口能不能满足你的文章转换需求
- 主题和输出效果是不是符合预期
- 你自己的系统能不能顺利接入
那就先拿试用 key。
试用 key 为什么会过期?
这个设计用于避免试用无限期外溢。
对你来说,只要记住这一句:
试用 key 会统一到时间自动失效。
也就是说,wmt_ 这类 key 本来就是为了短期验证,不适合长期依赖。
如果你发现昨天能用、今天突然失效了,第一反应先看是不是试用 key 到期了。
申请前最好准备什么?
如果你想更快拿到可用 key,建议提前准备这几样信息:
1. 你的使用场景
比如:
- 只是本地测试
- 接公司内部内容系统
- 给 Agent 做自动发布
- 用在自媒体或企业内容工作流
2. 你准备怎么接
大致说清楚:
- 手工调用 API
- 接自己的后端
- 接 Agent
- 接自动化平台
3. 你现在更需要哪类 key
比如:
- 先要试用 key
- 直接申请正式 key
如果你一开始就把这几件事说清楚,申请过程会快很多。
去哪里申请?
最直接的入口就是站内 API 文档页。
你可以从这里开始:
/api-docs
文档页里已经有联系入口和申请入口。
如果我只是想先跑通一次,最适合拿哪类?
最适合的是:
wmt_
因为你只是验证:
- 接口是不是通
- 输出是不是符合预期
- 请求头和参数是不是都能跑
这个阶段没有必要一开始就把正式接入想得太重。
如果我已经确定要正式接入呢?
那就不要停留在试用 key。
直接申请:
wme2_
原因很简单:
- 命名已经稳定
- 更适合后续正式统计和管理
- 不会被试用过期规则影响
申请之后怎么最快验证?
拿到 key 后,不要一上来做复杂集成。
先发一条最小请求:
curl -X POST "https://www.md2wechat.cn/api/convert" \
-H "Content-Type: application/json" \
-H "X-API-Key: wme2_your_api_key_here" \
-d '{
"markdown": "# 标题\n\n这是一段正文。"
}'
如果你拿到的是试用 key,就把 wme2_... 换成 wmt_...。
申请后最容易误解的 3 件事
1. 试用 key 不是正式 key
它适合验证,不适合长期依赖。
2. 旧 key 不是默认推荐
wme_ 还有效,但新接入优先用 wme2_。
3. key 失效不一定是接口坏了
特别是 wmt_,很多时候只是试用到期了。
如何选择
如果你还在判断值不值得接:
- 先申请试用 key
如果你已经确认会长期使用:
- 直接申请正式 key
如果你是老用户,手里已经有旧 key:
- 可以继续用
- 但后续新接入更建议走新正式 key
继续往下读
拿到 key 后,推荐直接接这两篇: