隨著人工智慧(AI)浪潮席捲全球,OpenAI 推出的 ChatGPT 以其強大的自然語言處理能力驚艷世人。然而,除了在官方網站上與其互動,更令開發者與企業振奮的是,可以透過串接 chatgpt api(應用程式介面)將這股強大的 AI 力量整合進自身的應用程式與服務中。
這篇教學文章將深入淺出地介紹 ChatGPT API Key的各個面向,從核心概念、申請流程、費用結構,到實際的 Python 程式碼範例與進階應用,為您提供一份詳細且完整的操作指南,助您輕鬆駕馭 AI,開創更多可能性。
核心概念:API、Token 與模型
在深入探討如何使用 ChatGPT API 之前,讓我們先來了解幾個核心概念,這些在官方文檔中都有詳細說明:
- API (Application Programming Interface): 應用程式介面,可以想像成是兩個不同程式之間溝通的橋樑。透過 API,開發者的應用程式可以向 OpenAI 的伺服器發送請求,並接收由深度學習模型(LLM)生成的文字回應。這使得開發者無需自行建構複雜的 AI 模型,即可在自己的產品中實現智慧對話、內容生成等功能。
- Token: Token 是大型語言模型處理文字的基本單位。它可以是一個單詞、一個字元或是一小段文字。OpenAI 根據每次 API 請求中輸入(Prompt)和輸出(Completion)的 Token 總數來計費。一般來說,英文單字通常等於 1 個 Token,而繁體中文則可能需要較多的 Token 來表示。
- 模型 (Model): OpenAI 提供了多種不同能力與價格的模型供開發者選擇。例如,功能強大但價格較高的 GPT-4 系列,以及性價比更高的 GPT-3.5-turbo 系列。開發者可以根據自身應用的需求與預算,選擇最合適的模型。
踏出第一步:申請您的 OpenAI API 金鑰
要開始使用 ChatGPT API,您首先需要一組專屬的 API 金鑰(apikey)與對應的組織 ID。以下是詳細的申請步驟教學:
- 註冊 OpenAI 帳戶: 前往 OpenAI 官方網站(https://openai.com/)並註冊一個 OpenAI 帳號。您可以使用 Google、Microsoft、Apple 帳戶快速註冊,或使用電子郵件註冊。註冊過程中需要手機號碼進行驗證。
- 尋找金鑰與 ID: 登入後,您會在開發者平台中進行操作。
- 取得 API 金鑰: 點擊左側選單的「API keys」,接著點擊「Create new secret key」按鈕,系統會立即生成一組獨一無二的API金鑰。
- 取得 Organization ID: 在左側選單點擊「Settings」,您就可以找到您的 Organization ID。在某些情況下呼叫 API 需要提供此 ID。
- 妥善保存金鑰: 請務必立即複製並妥善保存這組密鑰! 這是您唯一一次能看到完整金鑰的機會,一旦關閉視窗,將無法再次查看。API金鑰如同您帳戶的密碼,切勿外洩,以免造成不必要的費用損失。
費用與額度:了解您的花費
ChatGPT API 的收費方式主要採「以量計價」,根據您使用的token數量計費,這與月費制的chatgptplus不同。新註冊的帳戶通常會獲得一定的免費額度,讓您在初期可以無負擔地體驗 API 的功能。當免費額度或token額度用完後,就需要付錢購買使用額度。
計費方式
模型 | 輸入 (每 1K tokens) | 輸出 (每 1K tokens) |
---|---|---|
GPT-4o | 0.005 | 0.015 |
GPT-4 Turbo | 0.01 | 0.03 |
GPT-3.5-turbo | 0.0005 | 0.0015 |
方案說明
- 個人用戶: API 的花費與您是否訂閱 ChatGPT Plus 無關。Plus 方案主要提供網頁版更強大的模型與優先使用權,而 API 則需另外儲值付費。
- 企業版: 對於有大規模使用需求的用戶,OpenAI 也提供企業版方案,提供更高的使用額度上限、更快的服務以及企業級的資料安全保障。
注意事項:
- 價格會隨 OpenAI 的政策調整,請以官方最新的定價為準。
- 您可以隨時在帳戶的「Usage」頁面查看目前的使用量與花費。
- 為避免超支,建議在「Billing」頁面設定消費上限。
實戰演練:Python 調用 ChatGPT API 使用方式
掌握了基本概念後,讓我們透過 Python 程式碼,實際體驗如何與 ChatGPT API 互動。這個使用方法可以有效優化您的工作流程。
1. 安裝 OpenAI 套件
首先,您需要在您的 Python 環境中安裝 OpenAI 官方提供的套件:
pip install openai
2. 撰寫您的第一個 API 請求
以下是一個簡單的範例,展示如何透過串接發送一個請求並印出模型的回應。不同模型的回應速度會有所不同。
from openai import OpenAI
# 建議使用環境變數來管理您的 API 金鑰,而非直接寫在程式碼中
# client = OpenAI(api_key='YOUR_API_KEY')
import os
client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
completion = client.chat.completions.create(
model="gpt-3.5-turbo",
messages=[
{"role": "system", "content": "你是一個樂於助人的助理。"},
{"role": "user", "content": "你好,請介紹一下你自己。"}
]
)
print(completion.choices[0].message.content)
3. 更安全的金鑰管理:使用環境變數
直接將 API 金鑰寫在程式碼中是危險的作法。建議將金鑰設定為環境變數,增加安全性。
在 macOS/Linux 中設定:
export OPENAI_API_KEY=’您的API金鑰’
在 Windows 中設定:
set OPENAI_API_KEY=您的API金鑰
程式碼與 API 協定解析:
- from openai import OpenAI: 匯入 OpenAI 套件。
- client = OpenAI(…): 建立一個 OpenAI 客戶端。
- client.chat.completions.create(): 這是發送請求的核心方法。這個Python套件的呼叫,底層是向OpenAI的API端點發出一個 HTTP POST 請求,其標頭包含了 Content-Type: application/json。
- model: 指定您要使用的模型。
- messages: 一個包含對話歷史的列表,這是請求的主體內容,會被格式化為applicationjson。
- role: 角色,可以是 “system”(系統指示)、”user”(使用者提問)或 “assistant”(模型的回應)。
- content: 該角色的發言內容。
- print(completion.choices[0].message.content): 從回應中提取並印出模型的回答。
進階應用:Plugin 與 LangChain
除了基本的對話功能,串接openai的api還能透過 Plugin 和 LangChain 等工具,實現更強大、更客製化的應用,將其整合到更複雜的平台中。當應用程式的複雜程度提升時,這些框架便能派上用場。
Plugin: ChatGPT Plugin 允許模型與第三方應用程式進行互動,從而獲取即時資訊(如天氣、新聞)、存取私有知識庫,或代表使用者執行特定操作(如訂機票、預約餐廳)。這大大擴展了 ChatGPT 的能力邊界。
LangChain: LangChain 是一個開源框架,旨在簡化由大型語言模型驅動的應用程式的開發。它提供了一系列的工具和組件,讓開發者可以輕鬆地將語言模型與其他資料來源(如 PDF、資料庫)結合,並建立更複雜的應用,例如:
- 個人化問答機器人: 讓模型能夠根據您提供的文件內容回答問題。
- 智慧代理人 (Agent): 賦予模型使用工具(如搜尋引擎、計算機)的能力,以完成更複雜的任務。
常見問題 (FAQ)
Q1: 使用 ChatGPT API 是否完全免費?
A1: 不是的。新用戶通常會有一筆免費試用額度。當免費額度用完後,將根據您使用的 Token 數量進行收費。
Q2: 如果我的 API 金鑰不小心外洩了怎麼辦?
A2: 如果您懷疑 API 金鑰已經外洩,請立即登入您的 OpenAI 帳戶,將該金鑰刪除,並重新生成一組新的金鑰。
Q3: 我可以將 ChatGPT API 用於商業用途嗎?
A3: 可以的。許多企業已經將 ChatGPT API 整合到他們的產品和服務中,例如智慧客服、內容生成、市場分析等。
Q4: GPT-4 和 GPT-3.5-turbo 有什麼區別?我應該選擇哪一個?
A4: GPT-4 在處理複雜任務、理解細微指令和創造力方面通常優於 GPT-3.5-turbo,但價格也相對較高。如果您的應用對成本較為敏感,或任務相對簡單,GPT-3.5-turbo 會是個性價比很高的選擇。建議您可以先從 GPT-3.5-turbo 開始,再根據需求評估是否需要升級至 GPT-4。
總結
ChatGPT API 為開發者和企業開啟了一扇通往人工智慧世界的大門。透過本文的介紹,相信您已經對如何申請、使用及擴展 ChatGPT API 有了全面的了解。從簡單的對話機器人到複雜的智慧代理人,API 的應用潛力無窮,等待您來發掘。現在就動手申請您的 API 金鑰,開始打造屬於您的 AI 應用吧!
資料來源
- 如何使用ChatGPT API. 用Python 調用OpenAI 的API – Chris Lee
- 如何串接ChatGPT API? 快速教學指南
- ChatGPT API 是什麼?完整解析與應用指南