获取语音识别历史

获取语音识别历史，支持使用会话 ID 及 API Key 过滤识别历史。历史最长保存 7 天（按会话结束时间计）。

接口概览

接口地址: https://api.senseaudio.cn/v1/audio/records
请求方式: GET
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456…

请求参数 (Query Parameters)

参数名	类型	必填	描述
page	int	否	页数，默认为 1
page_size	int	否	分页大小，默认为 20
session_id	string	否	按照会话 ID 筛选
api_key	string	否	按照 API Key 筛选

响应结构

参数名	类型	描述
total	int	调用记录总数
list	array	查询得到的调用记录数据

list对象结构

参数名	类型	描述
api_key	string	此调用记录使用的 API Key
audio	string	此调用记录的音频文件，格式为 PCM s16le，采样率与声道数与此次会话的控制信息有关
points	int64	此次调用消耗的积分
session_id	string	此次调用的会话 ID
session_end	int64	此次调用会话的结束时间，UNIX 时间戳
session_start	int64	此次调用会话的开始时间，UNIX 时间戳
text	string	此次调用识别出的文本

响应示例

json

复制

{
  "total": 1,
  "list": [
    {
        "audio": "https://example.com/file/bcc1a46806d94bfef1a442f44e3cbe0a-record.pcm",
        "session_id": "bcc1a46806d94bfef1a442f44e3cbe0a",
        "session_start": 1772161815,
        "session_end": 1772161917,
        "api_key": "sk-123456",
        "points": 485,
        "text": "这是一个示例文本。"
    }
  ]
}

代码示例

CURL

bash

复制

curl --location --request GET "https://api.senseaudio.cn/v1/audio/records?page=1&page_size=20" \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY"

Python

python

复制

import requests
 
API_URL = "https://api.senseaudio.cn/v1/audio/records?page=1&page_size=20"
HEADERS = {
    "Authorization": "Bearer SENSEAUDIO_API_KEY"
}
 
def query_records():
    resp = requests.get(API_URL, headers=HEADERS)
    if resp.status_code == 200:
        return resp.json()
    return None

JavaScript

javascript

复制

const axios = require('axios');
 
const API_URL = 'https://api.senseaudio.cn/v1/audio/records?page=1&page_size=20';
const HEADERS = {
    'Authorization': 'Bearer SENSEAUDIO_API_KEY'
};
 
async function queryRecords() {
    try {
        const res = await axios.get(API_URL, {headers: HEADERS});
        return res.data;
    } catch (err) {
        console.error('请求失败:', err.message);
        return null;
    }
}