未授权
将音频文件转换为文字。支持公网 URL 或 base64 编码。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | string | 是 | 音频文件，支持公网 URL 或 base64 编码 |
{
"text": "识别出的文字内容"
}
将文字转换为语音。服务端内部处理异步轮询，直接返回音频数据。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 是 | 要合成的文字内容 |
| speed | float | 否 | 语速倍率，默认 1.0 |
| format | string | 否 | 返回格式，"json"(默认) 或 "binary" 直接下载音频 |
format=json (默认):
{
"audio": "base64编码的音频数据"
}
format=binary:
直接返回 audio/wav 文件
分析图片内容并返回描述。支持公网 URL、base64 编码，或直接使用 multipart/form-data 上传文件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image | string | 是 | 图片文件，支持公网 URL、base64 编码，或使用 multipart 直接上传 |
| prompt | string | 否 | 提示词，默认"请描述这张图片的内容" |
{
"result": "图片内容描述"
}
请描述这张图片的内容 - 通用描述这张图片里有哪些物体？ - 物体识别图片中的人在做什么？ - 行为分析提取图片中的文字 - OCR调用腾讯元器智能体进行多轮对话。学生需先在腾讯元器后台创建智能体，获取 assistant_id（appid）和 token（appkey）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| assistant_id | string | 是 | 智能体 ID（腾讯元器 appid） |
| token | string | 是 | 智能体调用密钥（腾讯元器 appkey） |
| messages | array | 是 | 对话消息数组，支持多轮 |
[
{"role": "user", "content": [{"type": "text", "text": "你好"}]},
{"role": "assistant", "content": [{"type": "text", "text": "你好！有什么可以帮你？"}]},
{"role": "user", "content": [{"type": "text", "text": "帮我查询天气"}]}
]
{
"content": "智能体的回复内容",
"images": ["https://example.com/image.png"],
"usage": {
"prompt_tokens": 100,
"completion_tokens": 50,
"total_tokens": 150
}
}
images 字段仅在回复包含图片时出现
向智能体发送一条消息并返回结果，简化版的智能体调用。支持附带一张图片。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| assistant_id | string | 是 | 智能体 ID（腾讯元器 appid） |
| token | string | 是 | 智能体调用密钥（腾讯元器 appkey） |
| prompt | string | 是 | 提问内容 |
| image | string | 否 | 图片 base64 编码（JSON 模式）或文件上传（multipart 模式） |
{
"content": "智能体的回复文本",
"images": ["https://example.com/generated.png"]
}
images 字段仅在回复包含图片时出现
查询当前 API Key 的调用记录。
| 状态码 | 含义 | 说明 |
|---|---|---|
| 200 | 成功 | 请求处理成功 |
| 400 | 参数错误 | 请求参数缺失或格式不正确 |
| 401 | 未认证 | API Key 无效或已过期 |
| 429 | 限流 | 触发 RPM 或总量限制 |
| 502 | 上游错误 | 移动云服务调用失败 |