AI服务

AI接口

模型列表

使用openai兼容的模型列表，可参考：https://platform.openai.com/docs/api-reference/models

GET /ai/v1/models

Authorization: Bearer sk-xxxxxxxxx

# 验收环境
curl https://uat-esp.xkw.cn/ai/v1/models \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ESP API KEY>" \

返回内容

{
   "data": [
       {
           "id": "glm-4",
           "object": "chat.completion.model",
           "owned_by": "zhipu-ai"
       },
       {
           "id": "gpt-4o",
           "object": "chat.completion.model",
           "owned_by": "azure"
       },
       {
           "id": "deepseek-r1",
           "object": "chat.completion.model",
           "owned_by": "tencent-llm,aliyun-bailian"
       },
       {
           "id": "qwen3-8b",
           "object": "chat.completion.model",
           "owned_by": "aliyun-bailian"
       },
       {
           "id": "text-embedding-3-small",
           "object": "text.embedding.model",
           "owned_by": "azure-east-us"
       }
   ],
   "object": "list"
}

目前支持的模型和提供商，持续增加中…

提供商名称	提供商用ID	模型ID列表
智谱AI	zhipu-ai	glm-4m，glm-4-plus，glm-z1-airx
微软OpenAI	azure	gpt-4-turbo，gpt-4o，gpt-4o-audio，gpt-o1-preview，gpt-4.1
腾讯云	tencent-llm	deepseek-r1，deepseek-v3，deepseek-v3-0324
阿里云	aliyun-bailian	qwen-max，qwen3-235b，qwen2.5-vl-7b-instruct，qwen3-8b，qwen3-14b

聊天模型

使用openai兼容的聊天模型，可参考：https://platform.openai.com/docs/api-reference/chat/create

POST /ai/v1/chat/completions

Authorization: Bearer sk-xxxxxxxxx

# 验收环境
curl https://uat-esp.xkw.cn/ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ESP API KEY>" \
  -d '{
        "model": "gpt-4o",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'

是否开户思考兼容不同的提供商，参数thinking_type，不开启：disabled，开启：enabled，GPT推理：minimal，low，medium，high

# 验收环境
curl https://uat-esp.xkw.cn/ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ESP API KEY>" \
  -d '{
        "model": "gpt-5",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "thinking_type":"medium",
        "stream": true
      }'

也可以使用不兼容的，按各自提供商的参数，比如GPT模型，使用reasoning: {“effort”:“medium”}

# 验收环境
curl https://uat-esp.xkw.cn/ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ESP API KEY>" \
  -d '{
        "model": "gpt-5",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        reasoning: {"effort":"medium"}，
        "stream": true
      }'

嵌入模型

使用openai兼容的嵌入模型，可参考：https://platform.openai.com/docs/api-reference/embeddings/create

POST /ai/v1/embeddings

Authorization: Bearer sk-xxxxxxxxx

# 验收环境
curl https://uat-esp.xkw.cn/ai/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ESP API KEY>" \
  -d '{
        "model": "text-embedding-v4",
        "input": "You are a helpful assistant.",
        "dimension": "1024",
        "encoding_format": "float"
    }'

秘塔搜索

POST /ai/v1/metaso/search

Authorization: Bearer sk-xxxxxxxxx

参数：

参数名称	描述
q	查询内容
scope	搜索范围，默认网页：webpage，文库：document，学术：scholar，图片：image，视频：video，播客：podcast
size	返回结果数量，默认：10
conciseSnippet	是否返回精简的原文匹配信息，默认：false
includeSummary	是否通过网页的摘要信息进行召回增强，默认：false
includeRawContent	是否抓取所有来源网页原文，默认：false

请求内容：

{
  "q": "巴浪鱼的营养价值",
  "scope": "webpage",
  "size": 2,
  "conciseSnippet": false,
  "includeSummary": false,
  "includeRawContent": false
}

返回内容：

{
    "credits": 3,
    "searchParameters": {
        "q": "巴浪鱼的营养价值",
        "scope": "webpage",
        "size": 2,
        "includeSummary": false,
        "includeRawContent": false,
        "conciseSnippet": false,
        "format": "chat_completions"
    },
    "webpages": [
        {
            "title": "巴浪鱼的营养价值探析",
            "link": "https://mobile-phone.taobao.com/baike/k/yingyang_2/768bd00752a916d9e70efb5efc75d6ea.html",
            "score": "high",
            "snippet": "一、富含优质蛋白质和Omega-3脂肪酸\n巴浪鱼，又称鳕鱼或白鱼，是一种深受人们喜爱的海鱼。\n其肉质细腻，含有丰富的蛋白质，每100克巴浪鱼肉就约含20克左右的蛋白质，这对于维持肌肉组织的健康和促进身体修复至关重要。\n同时，Omega-3脂肪酸，特别是DHA和EPA，是大脑发育和眼睛健康的必需营养素，巴浪鱼中的含量相对较高，有助于提高记忆力和视力保健。\n二、维生素与矿物质的宝藏\n巴浪鱼还富含维生素B12，这是一种对神经系统功能至关重要的营养素，对于素食者尤其重要，因为它们通常难以从植物性食物中获取。\n此外， 它还含有适量的钙、磷、铁等矿物质，这些对于骨骼健康、血液携氧能力以及铁元素缺乏导致的贫血有一定的预防作用。",
            "position": 1,
            "date": "2024年09月26日"
        },
        {
            "title": "巴浪鱼的营养和功效",
            "link": "https://www.yilianmeiti.com/article/2318321.html",
            "score": "high",
            "snippet": "巴浪鱼的营养通常是富含蛋白质、含有丰富的不饱和脂肪酸，功效是补充营养、提供能量、促进胃肠蠕动。\n一、营养\n1.富含蛋白质：巴浪鱼的蛋白质含量非常丰富，在每100克鱼肉中约含有20克以上的优质蛋白质。\n这些蛋白质含有人体所需的全部氨基酸，具有很高的生物学价值，能够被身体充分吸收利用。\n2.含有丰富的不饱和脂肪酸：尤其是ω-3多不饱和脂肪酸，对人体有很多益处，包括降低血脂、预防心血管疾病、抗炎抗氧化等。\n此外，ω-3多不饱和脂肪酸还对大脑发育和视力保护有很好的作用。",
            "position": 2,
            "date": "2024年09月02日"
        }
    ],
    "total": 32
}

秘塔简单问答

POST /ai/v1/metaso/chat/completions

Authorization: Bearer sk-xxxxxxxxx

参数：

参数名称	描述
q	查询内容
scope	搜索范围，默认网页：webpage，文库：document，学术：scholar，图片：image，视频：video，播客：podcast
model	模型，默认极速：fast，极速思考：fast_thinking，长思考R1：ds-r1
conciseSnippet	是否返回精简的原文匹配信息，默认：false

请求内容：

{
  "q": "巴浪鱼的营养价值高不高？仅需回答‘高’或‘不高’",
  "scope": "webpage",
  "model": "fast",
  "conciseSnippet": false
}

返回内容：

{
    "answer": "高",
    "sources": [
        {
            "title": "巴浪鱼的营养价值",
            "link": "https://m.iask.sina.com.cn/b/new1yGGtGutNDXn.html",
            "summary": "巴浪鱼具有较高的营养价值，能补充蛋白质，有助于补脑益智、祛风除湿、补肾补血。其蛋白质含量丰富，可促进新陈代谢，增强免疫力。同时富含磷脂和硒等微量元素，对预防风湿骨痛、改善肾虚和贫血有积极作用。文中还包含其他 unrelated 内容，如关于开颅手术后生存期的疑问、鹅的高傲表现、整形医院推荐、转轮术解释等，但这些内容与巴浪鱼的营养价值无关，未作深入讨论。",
            "date": "2024年07月28日"
        },
        {
            "title": "巴浪鱼养殖技术大全",
            "link": "http://ask.17house.com/q-378266.html",
            "snippet": "巴浪鱼的营养价值高不高\n- A：巴浪鱼，学名蓝圆鲹，别名又名刺巴鱼、棍子鱼、池鱼、黄占、池仔。\n是鲹科的一种海洋中上层鱼类 ，在我国南海、东海及黄海均有分布 ，尤以南海、东海产量较多。\n这种鱼肌*发达 ，味道鲜美 ，营养丰富，每百克鱼*含蛋白质 22. 7克 ，脂肪 2. 9克 ，是高蛋白且为人体吸收率较高的鱼。\n而且价格还很便宜。",
            "date": "2025年03月08日"
        },
        {
            "title": "核桃的功效与作用 营养价值这么高",
            "link": "http://ask.17house.com/q-402106.html",
            "snippet": "其规格通常为 3mm×3′×7′、 2.7～3 mm×4′×8′。也可根据客户要求按定单进行特殊规格生产。表面色彩鲜艳，品种繁多，深受建筑装饰业和家具*的喜爱。希望我的回答能帮助你。\n巴浪鱼的营养价值高不高\n\n- A：巴浪鱼，学名蓝圆鲹，别名又名刺巴鱼、棍子鱼、池鱼、黄占、池仔。是鲹科的一种海洋中上层鱼类 ，在我国南海、东海及黄海均有分布 ，尤以南海、东海产量较多。这种鱼肌*发达 ，味道鲜美 ，营养丰富，每百克鱼*含蛋白质 22. 7克 ，脂肪 2. 9克 ，是高蛋白且为人体吸收率较高的鱼。",
            "date": "2025年02月23日"
        }
    ],
    "credits": 6
}

腾讯录音文件识别

POST /ai/v1/tencent/flash-recognition

Authorization: Bearer sk-xxxxxxxxx

参数：

参数名称	描述
voiceUrl	录音文件地址
engineType	引擎模型类型，电话场景：8k_zh：中文电话通用，8k_zh_finance：中文电话金融，8k_en：英文电话通用。非电话场景：16k_zh：中文通用，16k_zh-PY：中英粤，16k_zh-TW：中文繁体，16k_zh_edu：中文教育，16k_zh_medical：中文医疗，16k_zh_court：中文法庭
voiceFormat	语音编码方式，可选，默认值为4。1：pcm；4：speex(sp)；6：silk；8：mp3；10：opus（opus 格式音频流封装说明）；12：wav；14：m4a（每个分片须是一个完整的 m4a 音频）；16：aac
speakerDiarization	话者分离，0-关闭，1-开启，默认：0
hotwordList	临时热词表：该参数用于提升识别准确率。

请求内容：

{
    "voiceUrl": "https://oss-dataoper-repo.oss-cn-hangzhou.aliyuncs.com/call-log/20210112/0026606b-65ac-40e3-8d34-6c5fbb9ac600.mp3?x-oss-credential=LTAI4Fo68Hmv3cCMPMWr6zKD%2F20251028%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20251028T030250Z&x-oss-expires=3600&x-oss-signature-version=OSS4-HMAC-SHA256&x-oss-signature=ef01281389244b85d5d9c8cff3a18cb88ff6215aa08e048af1da25a08204a357",
    "engineType": "8k_zh_large",
    "voiceFormat": "mp3"
}

返回内容：

{
    "request_id": "69003262aa5fe609eb0b04b0",
    "code": 0,
    "message": "",
    "audio_duration": 197939,
    "flash_result": [
        {
            "text": "喂你好喂喂，哎你好你好你好，是马主任吗。哎，你刚打电话了，对对对你好，那马主任这样呃，我这边这个贝壳资源网站的学科网胡瑞胜，然后那个早上客服这边有申请您一个这个在线呃，想体验一下学科网的是吧。啊，那个学科网，我们学校这有有那个账户了，嗯，诶那个您是在山东这边吗。啊，山东这边那个，咱们不是那个还没有合作吗？您的账号是您。所用的那个用个人账号是吧。啊个人账户啊啊用的那个个人账号，您看您用的个人账号呢，那那个平时肯定也有遇到一些这个像那个储值啊，精品啊，或者是高起点啊，这这个这个高起点啊这方面。都是需要充值去用的吗？啊嗯，对，您看您这方面就是要去充值。充值去用的，呃您看呃听您这么说，您应该对我们学科网也是挺了解的。呃，我们那个我们您看这么多老师，您这个老师充值用那个老师充值用一年下来也是要不少钱呢。我们也是看看那个学校老师在认可的基础上，能否这个做一个长期资源一个考虑呢，马主任。那个，你们那个会员多少钱一年？呃，一年的话，咱们是那个初中和高中是都有是吧？啊嗯，咱们是完中学校，完中学校呢，这个相对价格这个可能要高一些。呃，我们的这个包年服务原价的话，呃39800，现在做的优惠应该是在两万五左右一年。啊，对对对对，但是做多年期的话，呃，优惠要更多一些。做多年期，单独资源这方面，呃，3年也就在5万块钱。啊对对对对，那我先了解一下，我下来问一下学校，看怎么看有没有这样方面的那个啊。比这个这个我们学校有那个学科网的那个那个账户了，我先查一下吧，这个没有没有没有，我们学校没有合作。啊，嗯，我们学校没有合作这方面，这个今年教学这边也是您在负责吗，马主任？呃，我没有负责，我只是个人想用一下，所以就。所以申请一下啊，就是个人在再再用一下，那那个您这样呢，那个那个马主任近期的话，您看学校有没有相关行政会，呃您跟领导咱们那个提一下呢，新学期这个也不像说，呃今年也不像说去年这个年底由于一些经费紧张还是怎么样呢。近年这个经费应该也拨下来了。呃，行行，我现在再再考虑再看啊嗯，行行，那这样那那个方便加您一下微信吗，马主任。呃，行啊，你加吧这个电话号码嗯，好的好的好的好的，我稍后加您一下这个加您一下微信，然后刚刚那个报价，我给您做一份详细的报价方案，给您做一个电子档的发给您。嗯嗯，诶好的好的，那麻烦您费心了马主任。嗯诶诶好再见，诶冯主任好再见，嗯好。",
            "channel_id": 0,
            "sentence_list": [
                {
                    "text": "喂你好喂喂，哎你好你好你好，是马主任吗。",
                    "start_time": 540,
                    "end_time": 5230,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "哎，你刚打电话了，对对对你好，那马主任这样呃，我这边这个贝壳资源网站的学科网胡瑞胜，然后那个早上客服这边有申请您一个这个在线呃，想体验一下学科网的是吧。",
                    "start_time": 6520,
                    "end_time": 20110,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊，那个学科网，我们学校这有有那个账户了，嗯，诶那个您是在山东这边吗。",
                    "start_time": 21600,
                    "end_time": 29050,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊，山东这边那个，咱们不是那个还没有合作吗？您的账号是您。",
                    "start_time": 30340,
                    "end_time": 35790,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "所用的那个用个人账号是吧。",
                    "start_time": 35820,
                    "end_time": 38170,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊个人账户啊啊用的那个个人账号，您看您用的个人账号呢，那那个平时肯定也有遇到一些这个像那个储值啊，精品啊，或者是高起点啊，这这个这个高起点啊这方面。",
                    "start_time": 39120,
                    "end_time": 52490,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "都是需要充值去用的吗？",
                    "start_time": 52600,
                    "end_time": 54550,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊嗯，对，您看您这方面就是要去充值。",
                    "start_time": 55800,
                    "end_time": 59510,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "充值去用的，呃您看呃听您这么说，您应该对我们学科网也是挺了解的。呃，我们那个我们您看这么多老师，您这个老师充值用那个老师充值用一年下来也是要不少钱呢。我们也是看看那个学校老师在认可的基础上，能否这个做一个长期资源一个考虑呢，马主任。",
                    "start_time": 59560,
                    "end_time": 77950,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "那个，你们那个会员多少钱一年？呃，一年的话，咱们是那个初中和高中是都有是吧？",
                    "start_time": 79860,
                    "end_time": 86690,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊嗯，咱们是完中学校，完中学校呢，这个相对价格这个可能要高一些。呃，我们的这个包年服务原价的话，呃39800，现在做的优惠应该是在两万五左右一年。",
                    "start_time": 87820,
                    "end_time": 102250,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊，对对对对，但是做多年期的话，呃，优惠要更多一些。做多年期，单独资源这方面，呃，3年也就在5万块钱。",
                    "start_time": 103960,
                    "end_time": 113350,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊对对对对，那我先了解一下，我下来问一下学校，看怎么看有没有这样方面的那个啊。",
                    "start_time": 115140,
                    "end_time": 122790,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "比这个这个我们学校有那个学科网的那个那个账户了，我先查一下吧，这个没有没有没有，我们学校没有合作。",
                    "start_time": 122840,
                    "end_time": 131890,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "啊，嗯，我们学校没有合作这方面，这个今年教学这边也是您在负责吗，马主任？",
                    "start_time": 133160,
                    "end_time": 138870,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "呃，我没有负责，我只是个人想用一下，所以就。",
                    "start_time": 140240,
                    "end_time": 143930,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "所以申请一下啊，就是个人在再再用一下，那那个您这样呢，那个那个马主任近期的话，您看学校有没有相关行政会，呃您跟领导咱们那个提一下呢，新学期这个也不像说，呃今年也不像说去年这个年底由于一些经费紧张还是怎么样呢。",
                    "start_time": 144080,
                    "end_time": 161270,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "近年这个经费应该也拨下来了。",
                    "start_time": 161300,
                    "end_time": 163630,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "呃，行行，我现在再再考虑再看啊嗯，行行，那这样那那个方便加您一下微信吗，马主任。",
                    "start_time": 166060,
                    "end_time": 172630,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "呃，行啊，你加吧这个电话号码嗯，好的好的好的好的，我稍后加您一下这个加您一下微信，然后刚刚那个报价，我给您做一份详细的报价方案，给您做一个电子档的发给您。",
                    "start_time": 174120,
                    "end_time": 186170,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "嗯嗯，诶好的好的，那麻烦您费心了马主任。",
                    "start_time": 187540,
                    "end_time": 190870,
                    "speaker_id": 0,
                    "word_list": null
                },
                {
                    "text": "嗯诶诶好再见，诶冯主任好再见，嗯好。",
                    "start_time": 191720,
                    "end_time": 195670,
                    "speaker_id": 0,
                    "word_list": null
                }
            ]
        }
    ]
}

腾讯实时语音识别

使用 websocket进行对接。

生产环境：wss://esp.xkw.cn/ai/ws/v1/tencent/asr?apiKey=xxx&engineModelType=xxx&voiceFormat=xxx

验收环境：wss://uat-esp.xkw.cn/ai/ws/v1/tencent/asr?apiKey=xxx&engineModelType=xxx&voiceFormat=xxx

测试环境：wss://test-esp.xkw.cn/ai/ws/v1/tencent/asr?apiKey=xxx&engineModelType=xxx&voiceFormat=xxx

开发环境：wss://dev-esp.xkw.cn/ai/ws/v1/tencent/asr?apiKey=xxx&engineModelType=xxx&voiceFormat=xxx

参数：

参数名称	描述
apiKey	接口密钥
engineType	引擎模型类型，电话场景：8k_zh：中文电话通用，8k_zh_finance：中文电话金融，8k_en：英文电话通用。非电话场景：16k_zh：中文通用，16k_zh-PY：中英粤，16k_zh-TW：中文繁体，16k_zh_edu：中文教育，16k_zh_medical：中文医疗，16k_zh_court：中文法庭
voiceFormat	语音编码方式，可选，默认值为4。1：pcm；4：speex(sp)；6：silk；8：mp3；10：opus（opus 格式音频流封装说明）；12：wav；14：m4a（每个分片须是一个完整的 m4a 音频）；16：aac

例如验收环境：

wss://uat-esp.xkw.cn/ai/ws/v1/tencent/asr?apiKey=sk-xxxxxxxxx&engineModelType=16k_zh&voiceFormat=10

构建高效的智能体

想象一下，构建中。。。