配置指南 · 5 分鐘搞定

手把手拿到 API Key,
讓 Typefree 跑起來

完全沒接觸過也別怕。跟著下面的圖一步步點,幾分鐘就行。每個看不懂的詞,我都給你翻譯成人話。

先說清楚:API Key 是啥?
你可以把它理解成一把「鑰匙」——它讓 Typefree 能用你自己賬號下的 AI 服務(把話變成字、把字理順)。 所以你要做的就三件事:① 去拿這把鑰匙 ② 複製它 ③ 粘進 Typefree。拿鑰匙不花錢,註冊個賬號、點幾下就有了。
1

要拿兩把鑰匙

Typefree 幫你做兩件事:把話變成字(識別,必須)+ 把字理順(潤色,可選)。識別用火山(豆包),潤色用阿里(通義千問),所以要拿兩把鑰匙。兩把都免費,各花幾分鐘。

🏆 就這一條路

火山識別 + 阿里潤色

要拿 2 把鑰匙

識別用火山(豆包),識別效果最好,免費時長也多(三檔共約 60 小時);潤色用阿里,每個模型送 100 萬 Token。

只要識別、不要潤色?那只拿火山這一把(第 3 步),第 2 步可以跳過。

第 2 步拿阿里的鑰匙,第 3 步拿火山的鑰匙,第 4 步填進 Typefree。

2

拿阿里的鑰匙

這把鑰匙給「語音最佳化」(潤色)用。只要識別、不要潤色的可以跳過這一步。

  1. 開啟阿里百鍊控制檯。
    ↗ 開啟阿里百鍊
    第一次會讓你註冊 / 登入阿里雲賬號、同意一個協議。同意後會自動開通、自動送你免費額度,不用單獨申請任何東西。(控制檯=阿里的網站後臺。)
  2. 點左側選單最下面的「API Key」。
  3. 新賬號第一次會讓你先做「實名認證」。點建立時如果彈出「您未完善個人基本資訊」,點彈框裡的「去完善」,按提示填你的真實姓名 + 身份證號(這是阿里的規定,大約 2 分鐘)。填完回到這個頁面、重新整理一下就能建立了。
    阿里新使用者實名認證提示
    點去完善
    新賬號第一次會彈這個提示。點「去完善」做實名認證(填真實姓名和身份證),2 分鐘搞定。已經實名過的老賬號看不到這個,直接跳下一步。
  4. 點頁面正中紫色的「建立 API Key」按鈕。
    阿里百鍊 API Key 頁
    點這裡建立
    API Key 頁正中間就是「建立 API Key」按鈕(不是右上角)。
  5. 彈出的框裡:業務空間選「預設業務空間」(一定要選,不選點確定會飄紅),描述可以不填,許可權保持「全部」,點「確定」。
    阿里建立 API Key 對話方塊
    選「預設業務空間」
    點確定
    業務空間選「預設業務空間」,描述可留空,許可權保持「全部」,點確定。
  6. 建立成功會彈出完整鑰匙(sk- 開頭),馬上點「複製」存好!
    阿里 API Key 建立成功,點複製儲存
    點複製
    或點下載存成檔案
    鑰匙那行只顯示這一次(圖裡已打碼)。點「複製」粘到備忘錄,或點「下載」存成檔案。
    ⚠️ 重要:這串完整的鑰匙只顯示這一次,關掉視窗後就只能看到前後幾位了。所以一定要當場複製、存到備忘錄裡。
3

拿火山(豆包)的鑰匙

這把鑰匙給「語音識別」用,必須拿。

  1. 開啟火山語音控制檯。
    ↗ 開啟火山語音控制檯(新版)
    第一次會讓你註冊 / 登入火山引擎賬號。
  2. 新賬號先做個「實名認證」(火山要求實名後才能開通服務)。在「賬號管理 → 實名認證」裡選個人認證,用微信 / 抖音 APP 掃臉最快,手機掃一下臉,1 分鐘搞定。
    火山引擎個人實名認證
    實名認證選「個人認證 → 微信/抖音 APP 掃臉認證」(圖中紅框),手機掃臉最快。已實名的老賬號跳過這步。
  3. ⚠️ 關鍵一步:開通「錄音檔案識別 1.0」和「2.0」兩個服務。火山和阿里不一樣——識別服務要單獨開通(都免費送額度)。在左側「系統管理 → 開通管理」的「大模型」標籤頁裡,找到這兩個、各點一次「開通」:
     ·「錄音檔案識別 1.0」= App 的極速版 + 標準版(這兩檔都在它裡面)
     ·「錄音檔案識別 2.0」= App 的 2.0
    開通這兩個,App 三檔就都能用了。
    火山開通管理頁
    ① 錄音檔案識別2.0
    開通
    ② 錄音檔案識別1.0
    開通
    系統管理 → 開通管理 →「大模型」標籤頁。把「錄音檔案識別 1.0」和「2.0」各點一次「開通」(都免費送額度)。1.0 裡含極速版+標準版,2.0 是 2.0 檔;漏開 App 用到時會失敗。
  4. 開通後,去「API Key 管理」拿鑰匙。
    📍 這個頁面在哪?在左側導航欄往下劃到底,「系統管理」分組裡(「開通管理、用量統計」下面)就是「API Key 管理」,點它進入。 進入後,平臺已自動建好一把(名字像「預設體驗中心使用」),點鑰匙後面的「👁 眼睛」看到完整的、點複製即可;或點左上「+ 建立 API Key」建個新的。
    火山語音 API Key 管理頁
    想建新的點這
    點👁看完整→複製
    「API Key 管理」頁(入口見上方提示)。左上「+ 建立 API Key」可建新鑰匙;預設那把點「👁 眼睛」看完整、複製即可。
4

把鑰匙填進 Typefree

  1. 開啟 Typefree 設定 → 模型。
  2. 「語音識別」:把火山的鑰匙貼進 API Key 框,識別版本預設「極速版」就行。
  3. 點「測試連線」,看到 ✓ 就成功了!
  4. 「語音最佳化」:選「百鍊(阿里)」,把阿里的鑰匙貼進去,再點一次「測試連線」。不想潤色就選「不最佳化」。
?

常見問題

找不到「API Key」選單怎麼辦?

阿里:在控制檯左側選單最下面。火山:在左側「系統管理」下面的「API Key 管理」。

免費額度能用多久?會偷偷扣錢嗎?

阿里 90 天、火山半年,到期作廢、不是永久。⚠️ 阿里額度用完後會自動扣費,建議進阿里控制檯開啟「免費額度用完即停」開關,就絕不會偷偷扣錢了。

點「測試連線」失敗?

八成是鑰匙沒複製全(前後帶了空格),或者服務商選錯了。重新複製完整鑰匙,確認識別框填的是火山的鑰匙、潤色框填的是阿里的,別填反。

✦

看不懂的詞,這裡查

API Key:一把「鑰匙」,讓 App 能用你賬號下的 AI 服務。
控制檯:服務商的網站後臺,管理你賬號的地方。
百鍊 / DashScope:阿里的 AI 平臺,識別和潤色都在它上面。
豆包語音 / 火山引擎:火山(位元組)的語音 AI,識別用它。