1. 登錄控制臺(tái):注冊(cè)完成后,進(jìn)入控制臺(tái)頁面,點(diǎn)擊“在線調(diào)試”。

控制臺(tái)

  1. 創(chuàng)建新應(yīng)用:點(diǎn)擊“創(chuàng)建新應(yīng)用”按鈕,在彈出的窗口中填寫應(yīng)用信息。

創(chuàng)建應(yīng)用

  1. 獲取密鑰:進(jìn)入應(yīng)用的服務(wù)詳情頁,訪問接口文檔并獲取 API 密鑰。

服務(wù)詳情

API Key 的可用性測(cè)試

在獲取 API Key 后,測(cè)試其可用性是確保其正常工作的關(guān)鍵步驟。以下是使用 Python 進(jìn)行快速測(cè)試的步驟。

安裝和配置

步驟一:在 Python 環(huán)境中安裝 PyPI 包。

pip install --upgrade spark_ai_python

步驟二:執(zhí)行以下 Python 代碼進(jìn)行測(cè)試。

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 搭建應(yīng)用的關(guān)鍵考慮因素

在使用星火語音大模型 API 開發(fā)應(yīng)用時(shí),除了獲取和測(cè)試 API Key,還需考慮以下因素:

接口說明

訊飛星火 API 提供多個(gè)版本的接口,每個(gè)版本的功能和計(jì)費(fèi)策略可能不同。在使用前,請(qǐng)?jiān)敿?xì)閱讀 產(chǎn)品頁面 的說明。

請(qǐng)求地址

星火大模型 API 支持多種版本,包括 Lite、Pro、Max 等。每個(gè)版本有獨(dú)立的 tokens 計(jì)量方式。

請(qǐng)求版本 請(qǐng)求地址
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

接口鑒權(quán)

通過 URL 鑒權(quán)來保護(hù) Web 應(yīng)用的敏感資源,確保 API 的安全訪問。有關(guān)鑒權(quán)的詳細(xì)信息,請(qǐng)參考 通用URL鑒權(quán)文檔。

接口請(qǐng)求

接口請(qǐng)求由 header、parameter 和 payload 三部分組成。以下是請(qǐng)求參數(shù)示例:

{
    "header": {  
        "app_id": "12345",  
        "uid": "12345"  
    },  
    "parameter": {  
        "chat": {  
            "domain": "generalv3.5",  
            "temperature": 0.5,  
            "max_tokens": 1024  
        }  
    },  
    "payload": {  
        "message": {  
            "text": [  
                {"role":"system","content":"你現(xiàn)在扮演李白..."}, 
                {"role": "user", "content": "你是誰"}, 
                {"role": "assistant", "content": "....."}, 
                {"role": "user", "content": "你會(huì)做什么"}  
            ]  
        }  
    }
}

訊飛星火 API 進(jìn)階指引

Function Call 說明

Function Call 是星火大模型能力擴(kuò)展的核心功能,支持識(shí)別并調(diào)度外部接口。此功能目前僅支持 Spark Max/4.0 Ultra 版本。以下是功能調(diào)用的請(qǐng)求示例:

{
    "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": "天氣插件可以提供天氣相關(guān)信息。",  
                    "parameters": {  
                        "type": "object",  
                        "properties": {  
                            "location": {  
                                "type": "string",  
                                "description": "地點(diǎn),比如北京。"  
                            },  
                            "date": {  
                                "type": "string",  
                                "description": "日期。"  
                            }  
                        },  
                        "required": [  
                            "location"  
                        ]  
                    }  
                }  
            ]  
        }  
    }
}

價(jià)格說明

星火語音大模型的價(jià)格根據(jù)不同版本和功能有所不同。詳細(xì)價(jià)格信息請(qǐng)參閱價(jià)格說明。

常見問題

FAQ

  1. 問:如何找到訊飛星火 API?

  2. 問:訊飛星火 API 的替代品有哪些?

  3. 問:如何進(jìn)行 API 的可用性測(cè)試?

總結(jié)

通過本文,您了解了如何獲取訊飛星火大模型 API Key,并通過詳細(xì)的步驟和示例進(jìn)行了可用性測(cè)試。希望本文能夠幫助開發(fā)者輕松集成星火語音大模型的強(qiáng)大功能。

上一篇:

訊飛星火文生圖的應(yīng)用與實(shí)現(xiàn)

下一篇:

使用 Polly API 實(shí)現(xiàn)高效文本轉(zhuǎn)語音服務(wù)
#你可能也喜歡這些API文章!

我們有何不同?

API服務(wù)商零注冊(cè)

多API并行試用

數(shù)據(jù)驅(qū)動(dòng)選型,提升決策效率

查看全部API→
??

熱門場(chǎng)景實(shí)測(cè),選對(duì)API

#AI文本生成大模型API

對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)

#AI深度推理大模型API

對(duì)比大模型API的邏輯推理準(zhǔn)確性、分析深度、可視化建議合理性

10個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)