星火语音大模型的 API Key 获取指南

在人工智能领域，语音识别和处理技术的进步令人瞩目。科大讯飞作为全球领先的智能语音和人工智能企业，其星火语音大模型 API 提供了强大的语音识别、语音合成和自然语言处理能力。本文将为您详细介绍如何获取星火语音大模型的 API Key，帮助开发者轻松集成这一强大工具。

获取星火语音大模型 API Key 的步骤

获取星火语音大模型的 API Key 是开发智能应用的第一步。以下是详细步骤：

访问官网：前往讯飞星火官方网站，这是获取 API Key 的起点。
注册成为开发者：点击页面右上角的“注册/登录”按钮，填写必要信息以完成注册。

注册页面

登录控制台：注册完成后，进入控制台页面，点击“在线调试”。

控制台

创建新应用：点击“创建新应用”按钮，在弹出的窗口中填写应用信息。

创建应用

获取密钥：进入应用的服务详情页，访问接口文档并获取 API 密钥。

服务详情

API Key 的可用性测试

在获取 API Key 后，测试其可用性是确保其正常工作的关键步骤。以下是使用 Python 进行快速测试的步骤。

安装和配置

步骤一：在 Python 环境中安装 PyPI 包。

pip install --upgrade spark_ai_python

步骤二：执行以下 Python 代码进行测试。

from sparkai.llm.llm import ChatSparkLLM, ChunkPrintHandler
from sparkai.core.messages import ChatMessage

SPARKAI_URL = 'wss://spark-api.xf-yun.com/v3.5/chat'
SPARKAI_APP_ID = ''
SPARKAI_API_SECRET = ''
SPARKAI_API_KEY = ''
SPARKAI_DOMAIN = 'generalv3.5'

if __name__ == '__main__':
    spark = ChatSparkLLM(
        spark_api_url=SPARKAI_URL,
        spark_app_id=SPARKAI_APP_ID,
        spark_api_key=SPARKAI_API_KEY,
        spark_api_secret=SPARKAI_API_SECRET,
        spark_llm_domain=SPARKAI_DOMAIN,
        streaming=False,
    )
    messages = [ChatMessage(
        role="user",
        content='你好呀'
    )]
    handler = ChunkPrintHandler()
    a = spark.generate([messages], callbacks=[handler])
    print(a)

使用 API 搭建应用的关键考虑因素

在使用星火语音大模型 API 开发应用时，除了获取和测试 API Key，还需考虑以下因素：

接口说明

讯飞星火 API 提供多个版本的接口，每个版本的功能和计费策略可能不同。在使用前，请详细阅读产品页面的说明。

请求地址

星火大模型 API 支持多种版本，包括 Lite、Pro、Max 等。每个版本有独立的 tokens 计量方式。

请求版本	请求地址
Spark4.0 Ultra	wss://spark-api.xf-yun.com/v4.0/chat
Spark Max-32K	wss://spark-api.xf-yun.com/chat/max-32k
Spark Max	wss://spark-api.xf-yun.com/v3.5/chat

接口鉴权

通过 URL 鉴权来保护 Web 应用的敏感资源，确保 API 的安全访问。有关鉴权的详细信息，请参考通用URL鉴权文档。

接口请求

接口请求由 header、parameter 和 payload 三部分组成。以下是请求参数示例：

{
    "header": {  
        "app_id": "12345",  
        "uid": "12345"  
    },  
    "parameter": {  
        "chat": {  
            "domain": "generalv3.5",  
            "temperature": 0.5,  
            "max_tokens": 1024  
        }  
    },  
    "payload": {  
        "message": {  
            "text": [  
                {"role":"system","content":"你现在扮演李白..."}, 
                {"role": "user", "content": "你是谁"}, 
                {"role": "assistant", "content": "....."}, 
                {"role": "user", "content": "你会做什么"}  
            ]  
        }  
    }
}

讯飞星火 API 进阶指引

Function Call 说明

Function Call 是星火大模型能力扩展的核心功能，支持识别并调度外部接口。此功能目前仅支持 Spark Max/4.0 Ultra 版本。以下是功能调用的请求示例：

{
    "header": {  
        "app_id": appid,  
        "uid": "1234"  
    },  
    "parameter": {  
        "chat": {  
            "domain": domain,  
            "random_threshold": 0.5,  
            "max_tokens": 2048,  
            "auditing": "default"  
        }  
    },  
    "payload": {  
        "message": {  
            "text": [  
                {"role": "user", "content": ""}  
            ]  
        },  
        "functions": {  
            "text": [  
                {  
                    "name": "天气查询",  
                    "description": "天气插件可以提供天气相关信息。",  
                    "parameters": {  
                        "type": "object",  
                        "properties": {  
                            "location": {  
                                "type": "string",  
                                "description": "地点，比如北京。"  
                            },  
                            "date": {  
                                "type": "string",  
                                "description": "日期。"  
                            }  
                        },  
                        "required": [  
                            "location"  
                        ]  
                    }  
                }  
            ]  
        }  
    }
}