吐槽下腾讯混元大模型的 API，不敢相信这是腾讯的水平

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 421 天前的主题，其中的信息可能已经有所发展或是发生改变。

最近为 AIdea 项目对接了很多大模型的 API ，包括百度、阿里、OpenAI 、科大讯飞、商汤日日新，昨天对接了下腾讯的混元大模型 API ，发现腾讯提供的 API 竟然是最难用的，复杂、错误百出，不得不来吐槽下了！

官方 API 地址在这里 https://cloud.tencent.com/document/product/1729/97732

第一个槽点是请求参数签名，这一部分简直是噩梦，对开发者十分不友好，官方只提供了个 Python 的示例，其它语言只能自己去实现，也不清楚搞个这么复杂的签名的意义何在，在安全性方面起了什么作用，其它厂商大都是指定 AccessKey 和 Secret 就可以了。

第二个槽点是文档错误

错误 1
错误 2
错误 3

因为 AIdea 项目的服务端 mylxsw/aidea-server 是 Golang 开发的，所以各位 Go 爱好者们可以直接来抄作业啦，混元大模型的 Go 实现已经为你写好了，在这里看

https://github.com/mylxsw/aidea-server/tree/develop/internal/ai/tencentai

另外，关于 AIdea 项目，这里就不多介绍了，感兴趣的看这里

第 1 条附言 · 2023-09-21 16:14:32 +08:00

刚看了下最新的文档，文中说的错误官方已经修改了

aidea

套壳

槽点

App

90 条回复 • 2024-07-10 16:13:50 +08:00

me1onsoda

2023-09-21 12:21:48 +08:00

这不是腾讯稳定发挥吗

Bazingal

2023-09-21 12:24:47 +08:00

很正常，腾讯的文档不是一直出了名的烂吗

mmm159357456

2023-09-21 12:27:34 +08:00

tx 的请求参数签名很多服务都有啊，不光是这个

mylxsw

2023-09-21 12:34:43 +08:00

@mmm159357456 之前对接过其它的服务，用的是 SDK ，不过这个混元大模型还没有官方 SDK ，也没有文档引导开发者去找以前的实现示例，单纯只是对接混元大模型的时候就就只能开发者自己去实现参数拼接和签名算法这部分了，毕竟新人也不清楚这个签名算法和其它服务的实现是不是一样的

mylxsw

2023-09-21 12:35:08 +08:00

@Bazingal 是我孤陋寡闻了😂

mylxsw

2023-09-21 12:35:32 +08:00

@me1onsoda 😄

nomagick

2023-09-21 12:46:30 +08:00

签名没问题，但关心 body 的格式和内容就过分了，谁设计的，不胜任，并且已经影响了商誉

kneo

2023-09-21 12:47:29 +08:00 via Android

还好吧，都没验证客户端时间戳，谈不上复杂。

Breacher

2023-09-21 12:50:05 +08:00 via iPhone

祖传签名🥺

cp19890714

2023-09-21 12:57:09 +08:00

腾讯传统。
另外，腾讯的文档烂也是传统

Senorsen

2023-09-21 13:04:31 +08:00

正常，之前接微信支付和公众号的 API ，各种英文拼写错误和大小写不一致，可能腾讯就是不在乎给大家喂💩吧

totoro52

2023-09-21 13:08:31 +08:00

腾讯很多业务都是外包的

Hider5

2023-09-21 13:09:00 +08:00

腾讯是这样的，之前写微信小程序，踩了好多文档的坑

coolair

2023-09-21 13:50:56 +08:00

这才是腾讯啊，原来它的小程序、公众号就是这么设计的，文档也是这么烂的。

sechi

2023-09-21 13:51:44 +08:00

微信小程序的文档出了名的💩

cloudzqy

2023-09-21 13:53:38 +08:00

看标题， [难以置信是腾讯的水平] ，我还以为你是要夸混元大模型 api 非常好呢。
腾讯 api 和文档烂是众所周知的事实。你肯定没开发过小程序和公众号

Leviathann

2023-09-21 13:53:40 +08:00

对接过微信 api 都应该知道腾讯是个什么勾吧

shuson

2023-09-21 13:55:20 +08:00

签名有 golang 的例子，此外还有 node 等
文档的确细节的确不够准确

murmur

2023-09-21 13:55:32 +08:00

你应该庆幸文档对应的功能存在，小程序这次隐私弹窗文档出来了但是背后的功能还没做完

php01

2023-09-21 13:59:15 +08:00

这个产品应该是他们内部做的没错了，绝对不是外包的水平。

mylxsw

2023-09-21 14:03:08 +08:00

@cloudzqy 确是没开发过，算是第一次用腾讯的 API （短信除外）

mdgwmt0

2023-09-21 14:04:51 +08:00 via iPhone

你不觉得 tx 开发的东西都透露着一股二逼气息吗

xiaocaiji111

2023-09-21 14:09:47 +08:00

你去看看腾讯小程序社区多少人骂的，简直离谱。

duke807

2023-09-21 14:11:06 +08:00 via Android

但凡有一点能力，会给互联网公认毒瘤卖命？

kkk9

2023-09-21 14:20:52 +08:00

文档一般是实习生写的，真开发没有时间……

ericshen

2023-09-21 14:33:02 +08:00

不幸在 16 年对结果 WX 的支付 API 和公众号 API ，那真不是一般的烂

atpex

2023-09-21 14:36:13 +08:00

习惯就好，tx 就连 DNSPod 的 api 文档也能出错，我记得好像文档上说是要写定 UA 才合法。但实际是不能加 UA ，否则 403 。

8355

2023-09-21 14:36:44 +08:00

对比下火山或者头条的 api 差距真的是高下立判

x86

2023-09-21 14:41:08 +08:00

腾讯的文档出了名的烂，不及时更新，返回数据不对版

ZettarYuFan

2023-09-21 14:49:21 +08:00

签名是真的蠢，我看到这个签名想合到自己的项目里面都头大

Katrol

2023-09-21 14:51:22 +08:00

正常现象，腾讯除非全力拿资源 all in 某件事情，会做的很认真，不然跟一般公司差别不大

realzzz

2023-09-21 14:53:37 +08:00

腾讯文档，那就不奇怪了

dsb2468

2023-09-21 14:56:22 +08:00

之前第一次阅读微信支付的开发文档时，我发现官方的示例程序还需要修改才能编译成功时，我也是这么震惊的。。

icyalala

2023-09-21 14:59:44 +08:00

签名算法倒没什么，但是文档烂开发者不友好这个是出名的，从没改过

mooyo

2023-09-21 15:07:31 +08:00

有文档不错了。。你等他再迭代几版你可能用 API 都得靠猜了。

yangzzzzzz

2023-09-21 15:10:00 +08:00

微信公众号小程序的文档跟屎一样有时候修改了特性不更新文档，以为是自己程序的问题，该死

nodejsexpress

2023-09-21 15:13:45 +08:00

看看那个公众号小程序的文档，只有 php 代码示例，就是一群不知所谓的人在开发。

帮助文档里有些 url 跳转，点进去呢还 404 。

这业余程度，我直呼外行。

ck65

2023-09-21 15:16:14 +08:00

做微信小程序、开放平台开发形如吃屎，老传统了，你忍一下。

byaiu

2023-09-21 15:36:08 +08:00

腾讯其实不能视作一个大公司，应该视作不同的小公司的集合。
从这个角度来看，应该很多东西就能说得通了

maocat

2023-09-21 15:42:54 +08:00

对接过法大大的 api ，竟然每个接口的签名是单独搞的(比如某一接口明确要求不要某个字段参与验签)

返回 code 有的是 int 有的是 string

请求的 url 有的是驼峰有的是蛇形还有的混用

pkoukk

2023-09-21 15:48:27 +08:00

签名没啥问题，虽然繁琐了一点，但一般是网关要求，锅不在业务身上
至于文档内容的烂，确实是超出了意料，腾讯是完全不打算做 2B 业务是么

bookbox

2023-09-21 16:05:15 +08:00

我看目前没有 op 说的这些文档错误了，改的挺快的。以后上线了 sdk ，统一了 api 接口版本应该会好一点的吧。

Essaim

2023-09-21 16:08:18 +08:00

工作需要对接企业微信和微信公众号，整个业务流程真是灾难级的难理解。

tanghanyu

2023-09-21 16:08:21 +08:00

appid+appsecret+时间戳加密后再编码倒是挺常见的了，不过 demo 和文档写成这样就是有点恶心人了

barbery

2023-09-21 16:09:34 +08:00

看过微信文档的都知道垃圾腾讯

mylxsw

2023-09-21 16:13:46 +08:00

@bookbox 刚看了下，确实是改了，上午还是错误的😂

s609926202

2023-09-21 16:31:32 +08:00

我发送复杂点的提示词，直接返回签名错误（ 2001 ），当替换成“你是谁？”、“你能做什么？”的提示词后，可以正常返回。。

用的是 PHP 语言，拼接 message 字符串时，使用 json_encode('xx', JSON_UNESCAPED_UNICODE)，不清楚是哪里的问题、、

复杂提示（包含了换行符）：
```
The following production process records are summarized by extracting the goodsSpec, count, pici, receive, workName, and toWorkName from the text and outputting a JSON object containing an array of these entities using the following format:

---
example:

Input:
目检转入壳灌胶\nabc 6 只 2308 周 @张三 @李四

Output:
[
{
"product": "abc",
"count": "6",
"pici": "2308",
"receiver": "张三,李四",
"wn": "目检",
"toWN": "入壳灌胶",
"remark": ""
}
]

---
Input:
测试合格
abcd 2 只 2320 周
@王麻子

The Output is:
```

gadfly3173

2023-09-21 16:34:05 +08:00 via Android

你猜对接微信支付/小程序/公众号的开发者骂了腾讯多少年😆

Hilong

2023-09-21 16:35:59 +08:00

让我想起来了 16 年刚接公众号和小程序的时候的往事，妈的安卓和 ios 版本 sdk 的 key 的大小写不一样你能信？我 debug 这个 bug 人都搞懵了，

wuhang89

2023-09-21 16:38:11 +08:00

挺好的啊，这是腾讯稳定发挥的水平，说明腾讯经历裁员风波并没有降低他们的相应的开发水平，应该给予鼓励和支持。

s609926202

2023-09-21 16:52:14 +08:00

@s609926202 #47 替换了一下 message 字符串拼接方式正常了：

```
$str = '';
foreach ($val as $v) {
$str .= sprintf("{\"role\":\"%s\",\"content\":\"%s\"},", $v['role'], $v['content']);
}

$val = sprintf("[%s]", trim($str, ','));
```

EthanLiu1993

2023-09-21 16:53:26 +08:00

之前看星火的 api 是 ws ，然后就放弃了。感觉没必要🤣🤣

kljsandjb

2023-09-21 16:57:19 +08:00 via Android

这不就是腾讯这种烂厂的水平么。。。

vmebeh

2023-09-21 17:05:12 +08:00

说明还是人肉 Ctrl+C/V ，还没用 AI 来 Ctrl+C/V

seakingii

2023-09-21 17:15:06 +08:00

腾讯和阿里的文档都不咋地.对接他们的服务和 SDK 很痛苦.难以相像这几个大厂的水平

adoal

2023-09-21 17:32:41 +08:00

1. 国内一互大的工程质量基本上就是门前两坨物品，一坨是屎，另一坨也是屎
2. HMAC 签名还是挺简单也挺实用的，不过我遇见太多只有别人手把手写好调用代码才会用的人

adoal

2023-09-21 17:33:49 +08:00

3. 看来厂家真的有人在技术社区潜水😃

tt0411

2023-09-21 17:35:52 +08:00

腾讯 toB 或者 toD (developer) 的东西给我的感觉就是让二流外包公司做的 ...

ruoxie

2023-09-21 17:41:39 +08:00

@murmur 这个真的把我整笑了，一次次往后退，搞不定了，干脆自己整个系统弹框，苦了一大批拼命改的开发

leinad59

2023-09-21 17:42:53 +08:00

试过讯飞的星火。。签名生成也好麻烦，给的 demo 都跑不了

TenProX

2023-09-21 17:48:43 +08:00 via iPhone

这不应该是 TX 的正常表现吗，没必要大惊小怪的。千万别指望 TX 能做出惊为天人、引领行业的产品。

Mandelo

2023-09-21 18:04:40 +08:00

@mylxsw #46 有内鬼 😀

FrankAdler

2023-09-21 18:13:14 +08:00

这种体力活让实习生做很正常啊，我对接阿里，文档也是和实际对不上，问对接人员说是能用就这样用吧。

Courstick

2023-09-21 18:13:36 +08:00

腾讯的文档是出了名的垃圾，不过只要提出来修改的速度还是可以的，之前有提交过支付文档上的错误，下次看的时候就已经改正了

chenyu8674

2023-09-21 18:17:59 +08:00

腾讯正常水平+1

我用他家位置服务 API 遇到 Bug 提了俩工单

一个告诉我该问题已在其他工单被处理就直接关了，你特么倒是给我解决方式啊？？？

一个明明在官方 Demo 里改几行代码就能复现，结果回了个我个人使用方式有问题就给关了

haha512

2023-09-21 18:18:19 +08:00

腾讯：每天有一亿人教我怎么写文档。O(∩_∩)O~

encro

2023-09-21 18:23:44 +08:00

腾讯的精英都在游戏部门

xuanbg

2023-09-21 19:11:50 +08:00

这个不是正常发挥吗？你看微信的接口就知道了，没有最烂，只有更烂。

嗯，这让我想起倒下的两个巨头：诺基亚和摩托罗拉，他们的代码比腾讯还烂 100 倍。

iyaozhen

2023-09-21 19:38:40 +08:00

估计你第三方接口对接的少，哪有不需要签名的

之前写过自己公司的对外文档。怎么说呢，这个东西吃力不讨好，要写好非常耗时间（什么 api 规范化只能解决一部分问题），而且没收益。当然你会说写的好开发者接入的多，但说句实话你这开发者毫无价值。高价值的客户都是单独对接的，接口文档看不懂有问题都是 1 对 1 解决，而且别人还会夸你服务好，绩效就好。