跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt

Use this file to discover all available pages before exploring further.

雖然 Sunra 的 API 端點可以直接從客戶端程式碼存取，但在這樣的環境中儲存 API 金鑰會帶來重大的安全風險。為了解決這個問題，開發人員通常會建立自訂的伺服器端 API，在將結果傳回客戶端之前，安全地與像 Sunra 這樣的第三方服務互動。雖然這種方法有效，但它常常會分散團隊專注於其核心業務目標的注意力。 為簡化此流程，我們開發了支援代理模式的客戶端函式庫。此功能讓您能夠在前端程式碼中利用客戶端函式庫，同時將 API 金鑰安全地保留在您的伺服器端基礎設施中。

​
預先建置的代理程式解決方案

我們為幾個熱門的框架提供預先建置的代理程式解決方案：
  • Node.js with Next.js：一個 Next.js API 路由處理常式，可用於任何 Next.js 應用程式。它支援 Page 和 App 路由器。我們自己在所有生產環境中的應用程式都使用它。
  • Node.js with Express：一個 Express 路由處理常式，可用於任何 Express 應用程式。您也可以實作自訂邏輯並與您自己的處理常式組合。
我們致力於根據社群的回饋擴展我們的產品。如果您有特定的請求或建議，請與我們聯絡分享您的想法。

​
設定代理程式

若要整合代理程式功能，請在您的設定中指定 proxyUrl 來設定您的客戶端： 
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
此設定可確保 API 呼叫透過您的伺服器路由，從而增強安全性並簡化開發。