1. 從 sqlite3 到 AI 調(diào)用本地腳本里 Key 散落一地的真實(shí)痛點(diǎn)如果你用 Python 寫(xiě)過(guò)個(gè)人小工具大概率經(jīng)歷過(guò)這個(gè)階段一開(kāi)始只是import sqlite3建個(gè)test.db增刪改查跑得挺順。后來(lái)想給腳本加點(diǎn) AI 能力比如自動(dòng)給數(shù)據(jù)打標(biāo)簽、生成摘要、做語(yǔ)義去重于是代碼里開(kāi)始出現(xiàn)openai_api_key、base_url、model這些變量。再后來(lái)?yè)Q了另一個(gè)模型服務(wù)又加一組 Key。最后打開(kāi)文件一看數(shù)據(jù)庫(kù)連接和模型調(diào)用混在一起Key 散落在三四個(gè)地方改一次配置要翻半天。這篇就聚焦這個(gè)場(chǎng)景Python 開(kāi)發(fā)者用 sqlite3 做本地?cái)?shù)據(jù)讀寫(xiě)時(shí)怎么把模型調(diào)用和數(shù)據(jù)庫(kù)操作串成一條鏈路同時(shí)把 endpoint 和 Key 統(tǒng)一收口到一個(gè)通道。適合誰(shuí)適合寫(xiě)個(gè)人腳本、做小工具、跑本地?cái)?shù)據(jù)清洗的人。你不需要搭服務(wù)不需要 Docker一個(gè).py文件加一個(gè).db文件就能跑通。核心檢索詞先擺出來(lái)Python sqlite3 基本操作加上「本地?cái)?shù)據(jù)庫(kù) AI 調(diào)用最小示例」。我會(huì)先給一份能直接復(fù)制的 sqlite3 建表/增刪改查代碼再把模型調(diào)用的 endpoint 和 Key 改到 TaoToken 的配置片段最后附一次連接驗(yàn)證和查詢回顯動(dòng)作。目標(biāo)很明確你照著敲完能直接跑通。先說(shuō)清楚 sqlite3 是什么。它是 Python 標(biāo)準(zhǔn)庫(kù)自帶的輕量數(shù)據(jù)庫(kù)不需要單獨(dú)安裝數(shù)據(jù)存成一個(gè).db文件。能做什么建表、插入、查詢、更新、刪除事務(wù)提交。適合誰(shuí)適合數(shù)據(jù)量不大、單機(jī)運(yùn)行、不想折騰數(shù)據(jù)庫(kù)服務(wù)的場(chǎng)景。個(gè)人腳本、爬蟲(chóng)落地、配置存儲(chǔ)、小工具緩存都?jí)蛴?。而模型調(diào)用這塊很多人卡在「Key 管理」上。代碼里寫(xiě)死 Key 不安全多個(gè)服務(wù)各一套 Key 又難維護(hù)。把 endpoint 和 Key 統(tǒng)一到一個(gè)通道代碼里只留一個(gè)入口這是比較省心的做法。下面按步驟來(lái)。2. TaoToken 前置準(zhǔn)備統(tǒng)一 Key 通道與模型調(diào)用入口配置在動(dòng)手改代碼之前先把「通道」這件事說(shuō)清楚。你可以把 TaoToken 理解成一個(gè)統(tǒng)一的模型調(diào)用入口你只需要拿到一個(gè) API Key配一個(gè) Base URL代碼里所有模型請(qǐng)求都走這個(gè)入口。這樣 sqlite3 負(fù)責(zé)本地?cái)?shù)據(jù)模型調(diào)用負(fù)責(zé) AI 能力兩者通過(guò)一個(gè)配置變量解耦。前置準(zhǔn)備分三步。第一步拿到 API Key。訪問(wèn)控制臺(tái)創(chuàng)建 Key地址是https://taotoken.net/api-keys。創(chuàng)建后復(fù)制保存后面配置里要用。注意 Key 只顯示一次丟了就重新建一個(gè)。第二步確認(rèn) Base URL。API 入口是https://taotoken.net/api這個(gè)地址不加任何查詢參數(shù)直接作為base_url使用。很多 SDK 要求 base_url 以/v1結(jié)尾或者不帶具體看下面配置片段我會(huì)寫(xiě)清楚。第三步選模型 ID。模型對(duì)話頁(yè)面可以查看可用模型地址https://taotoken.net/model-chat。選一個(gè)你常用的模型 ID比如對(duì)話類(lèi)或代碼類(lèi)記下來(lái)配置里填進(jìn)去。這三樣?xùn)|西——Base URL、API Key、Model ID——就是后面所有配置的核心。我建議你不要把它們硬編碼在.py文件里而是放到環(huán)境變量或者一個(gè)單獨(dú)的配置文件。原因很簡(jiǎn)單腳本可能分享給別人Key 泄露風(fēng)險(xiǎn)高而且換模型時(shí)只改一處不用翻代碼。這里給一個(gè)推薦做法在項(xiàng)目根目錄建一個(gè).env文件或者直接用系統(tǒng)環(huán)境變量?jī)?nèi)容大致是TAOTOKEN_API_KEY你的Key TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_MODEL你的模型ID然后在 Python 里用os.environ讀取。這樣 sqlite3 的代碼和模型調(diào)用的代碼就徹底分開(kāi)了數(shù)據(jù)庫(kù)操作只管數(shù)據(jù)模型調(diào)用只管請(qǐng)求。如果你用的是 OpenAI 兼容的 SDK配置片段大概是這樣import os from openai import OpenAI client OpenAI( api_keyos.environ[TAOTOKEN_API_KEY], base_urlos.environ[TAOTOKEN_BASE_URL], ) MODEL_ID os.environ[TAOTOKEN_MODEL]注意base_url這里填的是https://taotoken.net/api不要自己加/v1或者別的路徑SDK 會(huì)處理。如果你用的不是 OpenAI SDK而是直接發(fā) HTTP 請(qǐng)求那 endpoint 就是https://taotoken.net/api加上具體的路徑具體看接入文檔https://taotoken.net/doc。前置準(zhǔn)備做完你手里應(yīng)該有一個(gè)能用的 Key、一個(gè) Base URL、一個(gè) Model ID。接下來(lái)進(jìn)入代碼環(huán)節(jié)。3. 可復(fù)制配置sqlite3 建表增刪改查 模型調(diào)用串聯(lián)代碼這一節(jié)是重點(diǎn)我給一份完整的、能直接跑的代碼。分兩部分先寫(xiě) sqlite3 的基本操作再把模型調(diào)用串進(jìn)去。你可以新建一個(gè)demo.py把下面代碼復(fù)制進(jìn)去改一下環(huán)境變量就能跑。先看 sqlite3 部分。建表、插入、查詢、更新、刪除五個(gè)動(dòng)作全覆蓋import os import sqlite3 DB_PATH test.db def init_db(): if os.path.exists(DB_PATH): os.remove(DB_PATH) conn sqlite3.connect(DB_PATH) cursor conn.cursor() cursor.execute( create table user(id int primary key, name varchar(20), tag varchar(50)) ) conn.commit() cursor.close() conn.close() def insert_user(uid, name): conn sqlite3.connect(DB_PATH) cursor conn.cursor() cursor.execute(insert into user (id, name, tag) values (?, ?, ?), (uid, name, )) conn.commit() cursor.close() conn.close() def query_users(): conn sqlite3.connect(DB_PATH) cursor conn.cursor() cursor.execute(select * from user) values cursor.fetchall() cursor.close() conn.close() return values def update_tag(uid, tag): conn sqlite3.connect(DB_PATH) cursor conn.cursor() cursor.execute(update user set tag ? where id ?, (tag, uid)) conn.commit() cursor.close() conn.close() def delete_user(uid): conn sqlite3.connect(DB_PATH) cursor conn.cursor() cursor.execute(delete from user where id ?, (uid,)) conn.commit() cursor.close() conn.close()這里有幾個(gè)細(xì)節(jié)值得說(shuō)。第一我用?占位符傳參而不是字符串拼接避免 SQL 注入這是 sqlite3 基本操作里必須養(yǎng)成的習(xí)慣。第二每次操作都commit()否則數(shù)據(jù)不落盤(pán)。第三cursor.close()和conn.close()成對(duì)出現(xiàn)避免連接泄漏。第四建表時(shí)多了一個(gè)tag字段這個(gè)字段后面用來(lái)存模型生成的標(biāo)簽把數(shù)據(jù)庫(kù)和 AI 調(diào)用串起來(lái)。接下來(lái)是模型調(diào)用部分。假設(shè)我們要給每個(gè) user 生成一個(gè)標(biāo)簽存回tag字段import os from openai import OpenAI client OpenAI( api_keyos.environ[TAOTOKEN_API_KEY], base_urlos.environ[TAOTOKEN_BASE_URL], ) MODEL_ID os.environ[TAOTOKEN_MODEL] def generate_tag(name): resp client.chat.completions.create( modelMODEL_ID, messages[ {role: system, content: 你是一個(gè)標(biāo)簽生成器只輸出一個(gè)中文詞。}, {role: user, content: f給這個(gè)名字生成一個(gè)標(biāo)簽{name}}, ], temperature0.3, ) return resp.choices[0].message.content.strip()然后把兩部分串起來(lái)if __name__ __main__: init_db() insert_user(1, Michael) insert_user(2, Alice) for uid, name, _ in query_users(): tag generate_tag(name) update_tag(uid, tag) for row in query_users(): print(row)跑完你會(huì)看到類(lèi)似(1, Michael, 音樂(lè))、(2, Alice, 閱讀)這樣的輸出。數(shù)據(jù)庫(kù)負(fù)責(zé)存模型負(fù)責(zé)生成Key 只在client初始化時(shí)用一次。如果你用 TOML 做配置可以這樣寫(xiě)[taotoken] api_key 你的Key base_url https://taotoken.net/api model 你的模型ID然后 Python 里用tomllib讀取。這樣配置和代碼分離換模型只改 TOML。如果你用 Cline MCP 或者 Codex 這類(lèi)工具配置里同樣要寫(xiě)全三件套Base URL、Key、Model ID。比如 Codex 的auth.json里base_url填https://taotoken.net/apiapi_key填你的 Key模型 ID 填你選的。三件套缺一不可少一個(gè)就會(huì)報(bào)鑒權(quán)或模型找不到的錯(cuò)。4. 驗(yàn)證請(qǐng)求與查詢回顯一次跑通的完整動(dòng)作代碼寫(xiě)完了怎么確認(rèn)真的跑通了我建議分兩步驗(yàn)證先驗(yàn)證 sqlite3 本身再驗(yàn)證模型調(diào)用最后看串聯(lián)結(jié)果。第一步單獨(dú)跑 sqlite3。把模型調(diào)用那部分注釋掉只跑init_db、insert_user、query_users。如果輸出[(1, Michael, ), (2, Alice, )]說(shuō)明數(shù)據(jù)庫(kù)操作沒(méi)問(wèn)題。這一步能排除掉「數(shù)據(jù)庫(kù)路徑不對(duì)」「表沒(méi)建成功」「commit 漏了」這類(lèi)問(wèn)題。第二步單獨(dú)驗(yàn)證模型調(diào)用。寫(xiě)一個(gè)最小腳本from openai import OpenAI import os client OpenAI( api_keyos.environ[TAOTOKEN_API_KEY], base_urlos.environ[TAOTOKEN_BASE_URL], ) resp client.chat.completions.create( modelos.environ[TAOTOKEN_MODEL], messages[{role: user, content: 回復(fù)兩個(gè)字收到}], ) print(resp.choices[0].message.content)如果打印出「收到」或者類(lèi)似內(nèi)容說(shuō)明 Key、Base URL、Model ID 三件套配置正確。這一步能排除掉「401 鑒權(quán)失敗」「模型 ID 寫(xiě)錯(cuò)」「base_url 多了 /v1」這類(lèi)問(wèn)題。第三步跑完整串聯(lián)。執(zhí)行demo.py觀察輸出。正常情況下你會(huì)看到每個(gè) user 的tag字段被填上了模型生成的內(nèi)容。如果tag還是空的說(shuō)明模型調(diào)用返回了空字符串或者update_tag沒(méi)執(zhí)行?？梢栽趃enerate_tag里加一行print(resp)看原始返回。這里給一個(gè)查詢回顯的檢查點(diǎn)跑完后單獨(dú)執(zhí)行一次query_users()把結(jié)果打印出來(lái)。如果tag字段有值說(shuō)明整條鏈路通了。如果報(bào)錯(cuò)看下面的排查章節(jié)。實(shí)測(cè)下來(lái)最容易出問(wèn)題的地方是環(huán)境變量沒(méi)生效。比如你在.env里寫(xiě)了 Key但 Python 沒(méi)加載.envos.environ[TAOTOKEN_API_KEY]就會(huì)拋KeyError。解決辦法是用python-dotenv加載或者直接在終端export。我試過(guò)在 PyCharm 里跑環(huán)境變量要在 Run Configuration 里單獨(dú)配這點(diǎn)容易踩坑。5. 本篇常見(jiàn)錯(cuò)排查401、local proxy failed、reading choices、OAuth這一節(jié)對(duì)照真實(shí)報(bào)錯(cuò)來(lái)。你在串聯(lián) sqlite3 和模型調(diào)用時(shí)大概率會(huì)遇到下面幾類(lèi)錯(cuò)誤。我按報(bào)錯(cuò)原文和解決思路列出來(lái)。401 Unauthorized。這是最常見(jiàn)的鑒權(quán)錯(cuò)誤。原因通常是 Key 沒(méi)填、Key 填錯(cuò)、或者 Key 前后有空格。檢查os.environ[TAOTOKEN_API_KEY]的值打印出來(lái)看長(zhǎng)度對(duì)不對(duì)。另外確認(rèn) Base URL 是https://taotoken.net/api不要寫(xiě)成別的路徑。如果 Key 是從控制臺(tái)復(fù)制的注意不要帶上多余換行。local proxy failed / connection error。這類(lèi)報(bào)錯(cuò)通常是網(wǎng)絡(luò)層的問(wèn)題。檢查你的網(wǎng)絡(luò)環(huán)境是否能正常訪問(wèn)https://taotoken.net/api?？梢杂胏url測(cè)一下curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d {model:你的模型ID,messages:[{role:user,content:hi}]}如果 curl 也失敗說(shuō)明是網(wǎng)絡(luò)或地址問(wèn)題如果 curl 成功但 Python 失敗說(shuō)明是代碼里的 base_url 或 SDK 配置問(wèn)題。reading choices 報(bào)錯(cuò) / choices 為空。這個(gè)報(bào)錯(cuò)通常出現(xiàn)在resp.choices[0]這一行。原因是模型返回結(jié)構(gòu)里沒(méi)有choices或者choices是空列表。常見(jiàn)觸發(fā)場(chǎng)景模型 ID 寫(xiě)錯(cuò)服務(wù)返回了錯(cuò)誤信息而不是正常補(bǔ)全或者請(qǐng)求被限流返回了錯(cuò)誤對(duì)象。解決辦法是先打印resp原始內(nèi)容看返回結(jié)構(gòu)。如果是模型 ID 問(wèn)題去模型對(duì)話頁(yè)面確認(rèn)正確的 ID。OAuth 相關(guān)報(bào)錯(cuò)。如果你用的是 Claude Code 或者某些需要 OAuth 的工具可能會(huì)遇到 OAuth 流程失敗。這類(lèi)工具通常需要你在配置里寫(xiě)全 Base URL、Key、Model ID 三件套。以 Claude Code 為例配置里ANTHROPIC_BASE_URL填https://taotoken.net/apiANTHROPIC_API_KEY填你的 Key模型 ID 填你選的。三件套寫(xiě)全OAuth 類(lèi)報(bào)錯(cuò)基本能消掉。如果還報(bào)錯(cuò)檢查配置文件路徑是否正確比如~/.claude/settings.json或者項(xiàng)目級(jí)的settings.json。sqlite3.OperationalError: no such table。這是數(shù)據(jù)庫(kù)側(cè)的錯(cuò)誤和模型調(diào)用無(wú)關(guān)。原因是建表語(yǔ)句沒(méi)執(zhí)行或者數(shù)據(jù)庫(kù)文件路徑不對(duì)。檢查init_db()是否在插入前調(diào)用檢查DB_PATH是否指向了正確的文件。如果你在多個(gè)目錄下跑腳本相對(duì)路徑test.db會(huì)在不同目錄生成不同文件建議用絕對(duì)路徑。sqlite3.ProgrammingError: Cannot operate on a closed database。這個(gè)錯(cuò)誤說(shuō)明你在conn.close()之后又用了cursor。檢查代碼順序確保commit()和close()在所有操作之后。排查思路總結(jié)成一句話先隔離再串聯(lián)。數(shù)據(jù)庫(kù)報(bào)錯(cuò)就單獨(dú)跑數(shù)據(jù)庫(kù)模型報(bào)錯(cuò)就單獨(dú)跑模型兩邊都通了再串起來(lái)。這樣定位問(wèn)題最快。6. 語(yǔ)義一致 CTA把這條鏈路用到你的長(zhǎng)期編碼場(chǎng)景到這里sqlite3 的基本操作和模型調(diào)用的串聯(lián)已經(jīng)跑通了。你手里有一份能直接跑的代碼建表、增刪改查、模型生成標(biāo)簽、回寫(xiě)數(shù)據(jù)庫(kù)。Key 只在初始化時(shí)用一次endpoint 統(tǒng)一到https://taotoken.net/api模型 ID 從環(huán)境變量讀。如果你只是偶爾跑跑腳本這套配置夠用了。但如果你要長(zhǎng)期做編碼、跑 Agent、或者把這條鏈路用到更多項(xiàng)目里建議看一下 Coding Plan地址是https://taotoken.net/coding-plan。它適合需要持續(xù)調(diào)用模型、管理多個(gè)項(xiàng)目的場(chǎng)景Key 和額度管理會(huì)更省心。另外兩個(gè)入口也放這里按需取用。需要驗(yàn)證模型效果、快速試對(duì)話去模型對(duì)話頁(yè)面https://taotoken.net/model-chat。需要管理 Key、創(chuàng)建新 Key去控制臺(tái)https://taotoken.net/api-keys。接入細(xì)節(jié)和參數(shù)說(shuō)明看文檔https://taotoken.net/doc。最后說(shuō)一個(gè)實(shí)用技巧把generate_tag這類(lèi)函數(shù)抽到一個(gè)單獨(dú)的ai_utils.py里數(shù)據(jù)庫(kù)操作抽到db_utils.py主腳本只負(fù)責(zé)編排。這樣下次換模型或者換數(shù)據(jù)庫(kù)只改一個(gè)文件。我試過(guò)在幾個(gè)小工具里這么拆維護(hù)成本低很多。代碼跑通只是開(kāi)始結(jié)構(gòu)清晰才能長(zhǎng)期用。