3.個(gè)人開發(fā)者注冊(cè)

3.1 輸入手機(jī)號(hào)

點(diǎn)擊“個(gè)人開發(fā)者”，進(jìn)入注冊(cè)頁(yè)面，輸入未注冊(cè)過的手機(jī)號(hào)，點(diǎn)擊下一步

3.2 輸入驗(yàn)證碼、密碼

輸入收到的驗(yàn)證碼，設(shè)置好密碼點(diǎn)擊下一步，即可自動(dòng)創(chuàng)建vivo帳號(hào)

2.能力接入

1.選擇接入能力

根據(jù)“首頁(yè)-產(chǎn)品-AI算法平臺(tái)”路徑進(jìn)入AI算法平臺(tái)頁(yè)面，選擇你需要的能力，點(diǎn)擊進(jìn)入能力詳情頁(yè)；

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

2.1點(diǎn)擊立即接入，進(jìn)入創(chuàng)建應(yīng)用界面；

2.2進(jìn)入創(chuàng)建應(yīng)用界面，按提示填寫應(yīng)用信息，選擇能力（默認(rèn)選中對(duì)應(yīng)能力），然后點(diǎn)擊立即創(chuàng)建，即可完成應(yīng)用創(chuàng)建（未完成注冊(cè)及資質(zhì)認(rèn)證的用戶無法創(chuàng)建應(yīng)用）；

3.查看應(yīng)用詳情

3.1在應(yīng)用管理頁(yè)面，點(diǎn)擊應(yīng)用名稱或“詳情”按鈕，進(jìn)入應(yīng)用詳情；

3.2在應(yīng)用詳情獲取APP ID、APP Key等信息；

3. 調(diào)用接口

生成簽名串

有了應(yīng)用的 app_id 和 app_key 后，就可以生成簽名串了。簽名串的計(jì)算公式如下：

__signature = base64_encode(HMAC-SHA256-HEX(app_key, signing_string))__

其中，signing_string 為：

signing_string = HTTP Method + “n” + HTTP URI + “n” + canonical_query_string + “n” + app_id + “n” + timestamp + “n” + signed_headers_string

signing_string中需要拼接的各個(gè)字段解釋如下：

• HTTP Method：指 HTTP 協(xié)議中定義的 GET、PUT、POST 等請(qǐng)求方法，必須使用全大寫的形式。
• HTTP URI：要求必須以“/”開頭，不以“/”開頭的需要補(bǔ)充上，空路徑為“/”。
• timestamp：請(qǐng)求時(shí)間（UTC時(shí)間），放在 X-AI-GATEWAY-TIMESTAMP 中。
• canonical_query_string：是對(duì)于 URL 中的 query（ query 即 URL 中 ? 后面的 key1=valve1&key2=valve2 字符串）進(jìn)行編碼后的結(jié)果。
• app_id：應(yīng)用標(biāo)識(shí), 放在 X-AI-GATEWAY-APP-ID 中。
• signed_headers_string：是從請(qǐng)求頭中獲取客戶端指定的字段，并按順序拼接字符串的結(jié)果。具體見下面描述

canonical_query_string 的生成步驟如下：

• 如果URL沒有query項(xiàng)，則canonical_query_string為空字符串，無需計(jì)算query項(xiàng)。
• 如果URL有query項(xiàng)，提取 URL 中的 query 項(xiàng)，即 URL 中 ? 后面的 key1=valve1&key2=valve2 字符串。
• 將 query 根據(jù)&分隔符拆開成若干項(xiàng)，每一項(xiàng)是 key=value 或者只有 key 的形式。
• 對(duì)拆開后的每一項(xiàng)進(jìn)行編碼處理，分以下兩種情況:
• 當(dāng)該項(xiàng)只有 key 時(shí)，轉(zhuǎn)換公式為 url_encode(key) + “=” 的形式。
• 當(dāng)該項(xiàng)是 key=value 的形式時(shí)，轉(zhuǎn)換公式為 url_encode(key) + “=” + url_encode(value) 的形式。這里 value 可以是空字符串。
• 將每一項(xiàng)轉(zhuǎn)換后，以 key 按照字典順序（ ASCII 碼由小到大）排序，并使用 & 符號(hào)連接起來，生成相應(yīng)的 canonical_query_string 。

signed_headers_string為：

signed_headers_string = "x-ai-gateway-app-id" + “:” + app_id + “n” + “x-ai-gateway-timestamp” + “:” + timestamp + “n” + “x-ai-gateway-nonce” + “:” + nonce

請(qǐng)求參數(shù)

Header如下：

body

businessid補(bǔ)充說明：

• 1990173156ceb8a09eee80c293135279，支持旋轉(zhuǎn)圖像、非正向文字識(shí)別
• 8bf312e702043779ad0f2760b37a0806，只支持正向文字識(shí)別，耗時(shí)比1990小

調(diào)用示例

#!/usr/bin/env python

# encoding: utf-8



import requests

import base64

from auth_util import gen_sign_headers



# 請(qǐng)注意替換APP_ID、APP_KEY、PIC_FILE

APP_ID = 'your_app_id'

APP_KEY = 'your_app_key'

DOMAIN = 'api-ai.vivo.com.cn'

URI = '/ocr/general_recognition'

METHOD = 'POST'

PIC_FILE = './test.jpg'





def ocr_test():

    picture = PIC_FILE

    with open(picture, "rb") as f:

        b_image = f.read()

    image = base64.b64encode(b_image).decode("utf-8")

    post_data = {"image": image, "pos": 2, "businessid": "1990173156ceb8a09eee80c293135279"}

    params = {}

    headers = gen_sign_headers(APP_ID, APP_KEY, METHOD, URI, params)



    url = 'http://{}{}'.format(DOMAIN, URI)

    response = requests.post(url, data=post_data, headers=headers)

    if response.status_code == 200:

        print(response.json())

    else:

        print(response.status_code, response.text)





if __name__ == '__main__':

    ocr_test()

響應(yīng)結(jié)果

result示例

請(qǐng)求參數(shù)pos為0

# angle可選的值為0/90/180/270 

{

    "result": {

        "words": [

            {"words": "取消"},

            {"words": "編輯"}

        ],

        "angle": 0

    }

}

請(qǐng)求參數(shù)pos為1

# angle可選的值為0/90/180/270，top_left：左上，top_right：右上，down_left：左下，down_right：右下，x、y：像素百分比

{

    "result": {

        "OCR": [

            {

                "words": "取消",

                "location": {

                    "top_left": {"x": 658.0, "y": 1130.0},

                    "top_right": {"x": 893.0, "y": 1130.0},

                    "down_left": {"x": 658.0, "y": 1174.0},

                    "down_right": {"x": 893.0, "y": 1174.0}

                }

            },

            {

                "words": "編輯",

                "location": {

                    "top_left": {"x": 398.0, "y": 825.0},

                    "top_right": {"x": 1912.0, "y": 825.0},

                    "down_left": {"x": 398.0, "y": 1004.0},

                    "down_right": {"x": 1912.0, "y": 1004.0}

                }

            }

        ],

        "angle": 0

    }

}

4. 常見問題

問題__1：如何找到藍(lán)心大模型 API__

冪簡(jiǎn)集成是國(guó)內(nèi)領(lǐng)先的API集成管理平臺(tái)，專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡(jiǎn)API平臺(tái)可以通過以下兩種方式找到所需API：通過關(guān)鍵詞搜索API(例如，輸入’藍(lán)心大模型 API‘這類品類詞，更容易找到結(jié)果)、或者從API hub分類頁(yè)進(jìn)入尋找。

問題__2：在“開發(fā)者助手”上提交問題，一般要填寫哪些信息？__

目前“開發(fā)者助手”上的工單主要分為兩大類型：

（1）一類是OriginOS 開放能力、AI大模型、藍(lán)河操作系統(tǒng)及其他開放內(nèi)容的相關(guān)咨詢，開發(fā)者需填寫標(biāo)題及詳細(xì)描述，如有需要可上傳圖片等相關(guān)附件對(duì)問題進(jìn)行更具體的描述。

（2）另一類是vivo系統(tǒng)上穩(wěn)定性、多媒體等的技術(shù)問題反饋，開發(fā)者需填寫標(biāo)題、詳細(xì)描述、機(jī)型、應(yīng)用名這些必要信息及其他如系統(tǒng)版本等相關(guān)信息。另外，為了vivo工程師可以更快速、準(zhǔn)確地對(duì)問題進(jìn)行分析，請(qǐng)?zhí)峁﹩栴}相關(guān)的日志。

問題__3：如何提交問題相關(guān)的日志？__

請(qǐng)按照以下步驟提交日志：

（1）打開電話，輸入##112## , 根據(jù)實(shí)際問題選擇具體的問題類型，一般情況下選擇“通用”類型。

（2）復(fù)現(xiàn)問題

（3）打開電話，輸入##112##，反饋，選擇所有時(shí)間段日志上傳。上傳完后提供日志提取碼給vivo。

問題__4：什么情況下需要日志打印授權(quán)？__

日志打印授權(quán)用于解決以下兩種情況：

一是日志中部分敏感信息以星號(hào)(**)顯示。–對(duì)應(yīng)權(quán)限：日志脫敏

二是日志打印太頻繁中間缺少部分日志。–對(duì)應(yīng)權(quán)限：行數(shù)限制

對(duì)于開發(fā)flutter應(yīng)用時(shí)出現(xiàn)無法調(diào)試的問題，可通過日志打印授權(quán)進(jìn)行解決

問題5：__藍(lán)心大模型 API 的替代品有哪些？__

提供AI大模型服務(wù)商除藍(lán)心大模型 API，還有其他替代服務(wù)商也提供類似api服務(wù)，__例如：__

Perplexity AI大模型

Copilot AI大模型

Flowise AI 大模型

更多競(jìng)品可以在冪簡(jiǎn)API平臺(tái)找到。

問題6：__藍(lán)心大模型 API這個(gè)密鑰還適用于哪些api__？

通用OCR、身份證識(shí)別、表格識(shí)別

5. 總結(jié)

本文詳細(xì)闡述了如何獲取藍(lán)心大模型API密鑰的全過程，從注冊(cè)賬號(hào)、成為開發(fā)者，到成功獲取密鑰并進(jìn)行初步測(cè)試，每一步都提供了清晰的指導(dǎo)。同時(shí)，還強(qiáng)調(diào)了在使用API時(shí)需要注意的關(guān)鍵因素，旨在幫助開發(fā)者更高效地集成藍(lán)心大模型的功能，以滿足實(shí)際應(yīng)用需求。