跳到主要内容

API Key / FIELD NOTES

如何获取 md2wechat API Key:正式 key、试用 key、申请前要准备什么

如果你最关心的是怎么拿到 API Key、试用 key 能用多久、正式 key 和试用 key 有什么区别,这篇文章会把申请路径和使用建议一次讲清楚。

如果你是第一次接 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 后,推荐直接接这两篇:

继续阅读

正式 key 和试用 key 怎么选?一篇讲清楚什么时候先试用,什么时候直接正式接入

不是所有人都应该先拿试用 key,也不是所有团队都该一上来申请正式 key。这篇文章会把选择标准拆开,让你根据自己的阶段判断应该走哪条路。

md2wechat API 快速开始:5 分钟跑通 Markdown 转公众号 HTML

如果你现在最需要的是先调通一次接口,这篇文章会给你最短路径:拿 key、发请求、看结果、排查第一类错误。

md2wechat API 常见错误排查:401、400、主题无效、试用 key 过期怎么处理

如果你已经开始调接口,但总是遇到 401、400 或主题错误,这篇文章会按真实排查顺序告诉你先查什么、后查什么,不让你盲猜。

YOUR NEXT ARTICLE

让下一篇文章,从清楚的排版开始。

先看效果,再把稳定的排版能力接入你的工作流。

如何获取 md2wechat API Key:正式 key、试用 key、申请前要准备什么