Adventists - API文档
    Adventists - API文档
    • 总览
    • 更新日志
    • 基本配置
    • 2.5 更新
    • Quick Start
    • TCP语音对话
      • TCP接入
      • MCP协议接入
      • WebSocket快速接入
      • VAD 模式接入指南
      • Emoji 模式对接指南
      • TCP获取Token
        POST
    • 配置管理
      • 模版 与 角色
      • 名词和参数说明
      • 模板
        • 查询公开模板列表
        • 查询当前组织模板(包含公开和私有模板)
        • 创建角色模板
        • 查询角色模板信息
        • 修改角色模板
        • 删除角色模板
        • 提交角色模板记忆
      • 角色
        • 创建角色(通过模板创建)
        • 创建角色
        • 查询角色
        • 修改角色
        • 删除角色
        • 发送角色记忆
        • 读取角色记忆
        • 创建角色(通过现有角色创建)
      • 技能书
        • 查询技能书列表
        • 预创建任务书
        • 上传任务书内容
        • 完成上传任务书
        • 查询技能书创建进度
      • 音色
        • 获取音色列表
        • 试听音色
        • 提交音色
        • 查询音色状态
    • 聊天辅助
      • 上传画面(Base64)
        POST
      • 上传画面(File)
        POST

    2.5 更新

    AnyoneAI v2.5 API 接口文档#

    概述#

    v2.5版本引入了大量新功能,包括扩展的Functions功能、OpenAI兼容接口、端侧MCP支持等。基于Anyone平行推理架构,默认提供流式响应。

    新增大量Functions功能#

    新增OpenAI兼容的 /chat/completions 接口#

    支持端侧MCP(Model Context Protocol)#

    流式响应现在是默认且唯一的响应模式#

    按角色封装,简化接口调用#

    接口认证#

    所有接口都需要在Header中携带以下参数:
    api_key: 32位字符串
    org_id: 6位字符串

    Functions 功能说明#

    v2.5大幅扩展了Functions功能,提供了丰富的外部接口调用能力,让AI可以执行各种实际任务。

    当前可用Functions#

    1.
    get_weather - 天气查询
    功能:获取实时天气信息
    使用场景:当用户询问天气状况时,自动获取当地未来五天的天气详情
    2.
    get_news - 新闻查询
    功能:获取实时新闻信息
    使用场景:用户询问最新新闻、热点事件时
    3.
    get_vision - 视觉能力
    功能:图像识别和处理
    使用场景:需要处理或识别图像内容时
    4.
    dance - 跳舞功能(数伴特供)
    功能:触发角色的舞蹈动作
    使用场景:互动娱乐场景
    5.
    search_internet - 网络搜索
    功能:使用Tavily AI进行实时网络搜索
    使用场景:需要获取最新信息、专业内容时
    特点:高精度、高相关性的搜索结果
    6.
    search_baidu - 百度搜索
    功能:使用百度进行中文搜索
    使用场景:中文内容的专业搜索
    7.
    read_url - 读取网页内容
    功能:提取指定URL的主要文本内容
    使用场景:需要获取特定网页的详细信息时
    8.
    book_house_service - 家政服务预约(爱国者特供)
    功能:预约各种家政服务(清洁、做饭、洗衣、跑腿等)
    使用场景:用户需要家政服务时
    支持:服务预约、商品购买(如买药)
    9.
    car_sales - 电动汽车销售信息(四有特供)
    功能:查询电动汽车品牌和型号信息
    使用场景:用户咨询电动汽车相关信息时
    10.
    tarot - 塔罗牌占卜
    功能:提供塔罗牌抽取和解读
    使用场景:用户需要占卜、寻求指引时
    支持:多种牌阵(三张牌、凯尔特十字等)
    11.
    bazi - 八字命理
    功能:基于出生信息进行八字命理分析
    使用场景:用户咨询命理相关问题时
    要求:需要完整的出生信息(年月日时、性别、历法)
    12.
    search_memory - 记忆搜索
    功能:搜索和回忆历史对话内容
    使用场景:需要参考之前的对话记录时
    13.
    lingtong_action - 灵童动作(灵童特供)
    功能:触发特定的动作效果
    使用场景:特定的交互场景

    Functions配置说明#

    1.
    配置方式
    {
        "functions": ["search_internet", "tarot", "bazi", "book_house_service"],
        "voice_id": "wukong"
    }
    2.
    使用特点
    每个角色可以配置多个functions
    系统会根据对话内容自动选择合适的function
    支持function的组合使用
    某些functions需要特定的输入参数

    OpenAI兼容接口#

    按角色封装的设计理念#

    与传统的OpenAI库不同,我们采用按角色封装的设计:
    不需要messages数组:直接使用prompt参数
    自动上下文管理:系统自动处理对话历史
    角色化交互:通过model参数指定角色ID

    /chat/completions 接口#

    POST /chat/completions

    认证方式#

    请求参数#

    {
        "model": "角色ID",
        "prompt": "用户输入的消息内容",
        "stream": true,
        "lang": "default",
        "emoji_mode": true,
        "audio_mode": true,
        "emotion_status": false,
        "tools": ["search_internet", "tarot"],
        "tool_call": false,
        "function_id": null
    }

    参数说明#

    参数名类型必填默认值说明
    modelstring是-角色ID(NPC ID)
    promptstring是-用户输入文本(直接使用,无需messages)
    streamboolean否true流式响应(目前只支持流式)
    langstring否"default"语言设置
    emoji_modeboolean否true是否启用emoji
    audio_modeboolean否true是否按语音要求断句
    emotion_statusboolean否false是否返回情绪状态
    toolsarray否[]可用的工具列表
    tool_callboolean否false是否为工具调用
    function_idstring否null具体的函数ID

    响应格式#

    采用标准的OpenAI流式响应格式:
    {
        "id": "chatcmpl-xxx",
        "object": "chat.completion.chunk",
        "created": 1234567890,
        "model": "角色ID",
        "choices": [
            {
                "index": 0,
                "delta": {"content": "响应内容"},
                "finish_reason": null
            }
        ]
    }

    使用示例#

    端侧MCP支持#

    什么是端侧MCP#

    端侧MCP(Model Context Protocol)允许你在发送的消息中直接嵌入MCP指令,与服务端的functions配合使用。具体可以看tcp接口的mcp文档。
    也可以在单纯使用http接口,用functions来传递mcp功能。

    流式响应特点#

    Anyone平行推理架构#

    默认流式:所有响应都是流式的,无法关闭
    平行推理:多个推理过程并行执行
    实时性:边计算边输出,提供最佳用户体验

    响应格式#

    传统接口:Server-Sent Events (SSE)
    OpenAI兼容接口:标准的OpenAI流式格式

    错误码说明#

    错误码说明
    200请求成功
    400请求参数错误
    401认证失败
    403权限不足
    404资源不存在
    429请求过于频繁
    500服务器内部错误
    601登录异常

    更新日志#

    v2.5版本主要更新:#

    1.
    大量新增Functions:从4个扩展到13个以上
    2.
    OpenAI兼容接口:新增 /chat/completions 端点
    3.
    端侧MCP支持:支持在消息中直接嵌入MCP指令
    4.
    流式响应优化:基于平行推理架构,默认流式响应
    5.
    按角色封装:简化接口调用,自动上下文管理
    6.
    移除过时功能:去除fast_mode、route等参数

    已废弃功能:#

    fast_mode 参数
    route 参数
    /prepare_fast_mode 接口
    非流式响应模式

    注意事项#

    1.
    认证安全:API KEY和ORG ID请妥善保管
    2.
    请求限制:prompt长度上限为1500字符
    3.
    频率控制:所有接口都有访问频率限制
    4.
    Functions权限:某些functions可能需要额外权限
    5.
    流式响应:目前仅支持流式响应,无法关闭
    6.
    兼容性:建议使用OpenAI兼容接口进行新开发
    修改于 2025-08-20 06:43:42
    上一页
    基本配置
    下一页
    Quick Start
    Built with