Source: https://ailoot.ai/models/zh-hant-tw/voyage-code-3/
Canonical: https://ailoot.ai/models/zh-hant-tw/voyage-code-3/
Language: zh-hant-tw

# Voyage AI: Voyage Code 3

[Markdown](https://ailoot.ai/models/zh-hant-tw/voyage-code-3/index.md) · [JSON](https://ailoot.ai/models/zh-hant-tw/voyage-code-3/facts.json)

## [Voyage AI: Voyage Code 3](https://ailoot.ai/models/zh-hant-tw/voyage-code-3/)

Voyage Code 3 為文字對程式碼、程式碼對程式碼，以及說明字串對程式碼的檢索建立嵌入。32,000 個 token 的視窗、可選向量維度與量化輸出，支援儲存庫搜尋及程式設計助理的程式碼脈絡選擇。

- [**Ailoot Ultra · 嵌入向量** `POST /v1/embeddings` `voyage-code-3`](https://ailoot.ai/models/zh-hant-tw/voyage-code-3/#method-0)

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

Voyage Code 3 是專門擷取原始碼的嵌入模型。開發商描述自然語言對程式碼、程式碼對程式碼，以及說明字串對程式碼的任務：問題可尋找實作，程式碼片段可尋找相關邏輯，函式描述可定位相關程式碼。模型產生檢索向量，而非編輯後檔案或完成程式。

依有意義的程式碼單位準備儲存庫素材。將函式與名稱、簽章及解釋用途的註解保留在一起。較大元件應加入理解操作所需的鄰近定義。將儲存庫、修訂版本、檔案路徑及行位置另外儲存，讓搜尋結果開啟當時建立嵌入的確切來源。

自然語言搜尋可以描述行為，例如尋找專案中在儲存上傳內容前先驗證的部分。程式碼查詢可以提供一個函式，尋找其他地方具有相符用途的實作。從實際開發任務選擇代表性搜尋，包括不熟悉的命名、相似實作，以及含義依賴周邊程式碼的工具。

32,000 個 token 的上下文視窗可容納大量程式碼段落。應有意識地運用空間：完整函式及其相關依賴，可能比在控制流程中間任意截斷的區塊更有資訊。保持來源格式可讀，擷取時保留程式語言語法。來源檔案超過輸入視窗時，在有用的結構邊界分割，並保留段落與母檔案的關係。

Voyage Code 3 支援 2,048、1,024、512 或 256 維嵌入，以及浮點、帶符號或無符號八位元與二進位表示。這些控制可支援不同儲存庫索引大小與搜尋設定。使用與較大基準相同的真實搜尋評估精簡表示，檢查正確函式或檔案是否仍出現在有用結果中。

程式設計助理應先擷取相關來源段落，再將段落及檔案參考提供給負責回答或變更的元件。相似度匹配有助選擇脈絡，不代表兩個實作可互換。在用擷取程式碼指引編輯前，先檢查輸入、副作用及周邊規格。

透過中繼資料分開儲存庫的不相關版本，並讓索引修訂版本可追溯。函式移動或行為變更時，同時更新向量與來源位置。索引來源與查詢應使用相同嵌入設定。遷移索引時，依既有問題集合比較結果，避免模型或向量表示變更在未被察覺的情況下，改變開發者看到的程式碼。

有用的檢查包括：查詢是否找到實際實作而非只有測試名稱、說明字串是否找到對應函式，以及是否能區分語意相關程式碼與表面相似片段。搜尋結果中保留回傳來源文字與位置，讓開發者檢查證據。這讓模型以程式碼為主的嵌入成為實用的導覽與脈絡選擇工具。

**Ailoot Ultra · 嵌入向量** `POST /v1/embeddings` `voyage-code-3`

[`voyage-code-3`](https://ailoot.ai/models/zh-hant-tw/#m=voyage-code-3&route=Ultra&caller=voyage-code-3&fmt=embeddings)

Voyage AI /`voyage-code-3`

### 入門

Voyage Code 3 為文字對程式碼、程式碼對程式碼，以及說明字串對程式碼的檢索建立嵌入。32,000 個 token 的視窗、可選向量維度與量化輸出，支援儲存庫搜尋及程式設計助理的程式碼脈絡選擇。

接受的輸入

文字

結果

embedding

### Ailoot 可用 · 輸入與方法

**Ailoot Ultra · 嵌入向量** `POST /v1/embeddings`

輸入

`text`

輸出

`embedding`

| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
| --- | --- | --- | --- | --- |
| 欄位`model` | 類型`string` | 要求必填 | 值與限制 voyage-code-3 條件: 請使用完全相符的 Ailoot 模型選擇值。 | 預設值— |
| 欄位`input` | 類型`string or array<string>` | 要求必填 | 值與限制 條件: 一段文字或文字清單；請為每個回傳的資料項目及其索引保留對應的向量。 | 預設值— |

方法參數與生命週期

| 參數 | 規格 |
| --- | --- |
| 參數`content_type` | 規格application/json |
| 參數`required` | 規格model, input |
| 參數`optional` | 規格 |
| 參數`material_types` | 規格text |
| 參數`conditions` | 規格請使用所選模型傳送文字；保留每個回傳的向量及其索引。 |

生命週期： `synchronous`

### 方案

費率資訊不會增加請求選項。支援的參數列於所選方法中。

快速模式

未指定 選取快速模式時

flex 模式

未指定 選取 flex 模式時

最高推理強度

未指定 最高推理強度採用 default 調整值時

#### Ailoot 費率

#### 各設定的價格

| 設定 | 費率表 | 費用 |
| --- | --- | --- |
| 設定基礎 token 費率 | 費率表基本費率 | 費用 輸入 · 輸入 Token **$0.0004** / 1K Token 輸出 · 輸出 Token **$0** / 1K Token 輸入 · 讀取快取 **—** / 1K Token 輸入 · 寫入快取 **—** / 1K Token 輸入 · 寫入快取，1 小時 **—** / 1K Token |

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。[預留金額與結算的運作方式 →](https://ailoot.ai/docs/zh-hant-tw/billing/reserve/)

### 請求範例

#### Ailoot Ultra · 嵌入向量

curl · 儲存所有向量與用量資料

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "voyage-code-3",
  "input": "The quick brown fox jumps over the lazy dog"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o embeddings.json
# Keep every data item and its index, the full usage object and response headers.
```

### 接收並儲存結果

### 別名

#### 模型別名

**Ailoot Ultra** [`voyage-code-3`](https://ailoot.ai/models/zh-hant-tw/#m=voyage-code-3&route=Ultra&caller=voyage-code-3&fmt=embeddings)

#### 方法路徑別名

請使用上方列出的 API 方法路徑。

#### 相關呼叫用 ID

[`voyage-code-3`](https://ailoot.ai/models/zh-hant-tw/#m=voyage-code-3&route=Ultra&caller=voyage-code-3&fmt=embeddings)

FAQ · Voyage AI: Voyage Code 3

可以使用哪些輸入與結果？

`POST /v1/embeddings` · `voyage-code-3`: `text` → `embedding`

請求使用哪些欄位？

`POST /v1/embeddings` · `voyage-code-3`: `model`, `input`

將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。

## 公司及其專案組合

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

## 優惠購買 token。

訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。

訂閱

為定期請求選擇優惠方案。

最高 50% 折扣碼

購買時輸入代碼，價格依活動重算。

歷史中的費用

每次請求保存模型、token 與金額。

[選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/)

## 將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。

商用應用程式

在付費功能加入文字、圖片、影片與聲音生成。

經銷授權

提供專案說明與存取方式，要求書面使用和轉售條件。

網站文件

串接前可閱讀正式服務條款、授權合約與資料處理政策。

[申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw)

## Ailoot · 公司及其專案組合





Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。





公司及其專案組合：數百萬客戶，每月銷售額達數十億。





Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。