Voyage AI: Voyage Code 3
Voyage Code 3 為文字對程式碼、程式碼對程式碼，以及說明字串對程式碼的檢索建立嵌入。32,000 個 token 的視窗、可選向量維度與量化輸出，支援儲存庫搜尋及程式設計助理的程式碼脈絡選擇。
關於模型
此說明介紹模型的能力。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入門
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 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · 嵌入向量
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
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Voyage AI: Voyage Code 3
- 可以使用哪些輸入與結果？
POST /v1/embeddings·voyage-code-3:text→embedding- 請求使用哪些欄位？
POST /v1/embeddings·voyage-code-3:model,input