← 開發者指南

您的第一次 SDK 呼叫

在任何頁面加入 script 標籤,完成您的第一次 ai.run() 翻譯呼叫 — 貼上、執行,即可看到翻譯結果。

這是從零到完成一次可運作 AI 呼叫最快的路徑 — 一個 script 標籤加上幾行 JavaScript。它使用共用的 dev 金鑰,讓您可以在完成 取得您的 API 金鑰 之前先行試用。

1. 加入 script 標籤

<script src="https://js.quravin.com/v1.js"></script>

2. 建立客戶端並呼叫 ai.run()

<button id="go">Translate</button>
<div id="out"></div>

<script>
  const ai = new Quravin.Quravin({
    endpoint: "https://api.example.com/ai-pipeline",
    apiKey:   "dev-replace-me",   // ← 換成您自己的金鑰,參見「取得您的 API 金鑰」
  });

  document.getElementById("go").onclick = async () => {
    const out = await ai.run({
      pipeline: "translate-string",
      inputs: { text: "Hello", target_language: "German" },
    });
    document.getElementById("out").textContent = out.translation;
  };
</script>

點擊按鈕 — out 會得到 { translation: "Hallo" }。這就是完整的一次來回:提交、輪詢、完成。

3. 換成您自己的金鑰

dev-replace-me 只能在 dev 環境中使用。完成 取得您的 API 金鑰 之後,請將 apiKey 換成您真正的金鑰 — 但絕對不要把正式金鑰放進瀏覽器程式碼中。正式環境的安全 做法請參見 選擇您的認證模式

下一步:在上線之前,請閱讀 選擇您的認證模式