Voyage AI: Voyage Code 2
Voyage Code 2 將原始碼與相關文字嵌入，用於語意儲存庫搜尋。自然語言問題、程式碼片段或組合查詢可擷取相關實作；這個版本使用 16,000 個 token 的上下文視窗與 1,536 維向量。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Voyage Code 2 為原始碼及相關文字建立數值嵌入。它為語意程式碼檢索設計：開發者描述行為或提供程式碼片段，搜尋系統便尋找相關實作。開發商範例涵蓋自然語言問題、程式碼片段，以及兩者組合作為搜尋輸入。
依實際開發問題建立儲存庫搜尋體驗。開發者可能尋找只移除第一個與最後一個符合字元的常式，或專案中使用特定樹狀遍歷的部分。準備精確表達行為的查詢，包括區分預期實作與相近但錯誤實作的條件。
以有用單位索引程式碼，不要依任意字元數切割每個檔案。將函式簽章、本體與相關說明保留在一起。輔助函式依賴區域型別或常數時，保留足夠周邊文字，讓其用途可理解。將檔案路徑、儲存庫修訂版本與來源位置儲存在嵌入以外，讓結果直接開啟原始碼。
這個版本具有 16,000 個 token 的上下文視窗，產生 1,536 維嵌入。依這種表示配置向量索引，並讓查詢與文件嵌入對應相同模型。已使用 Voyage Code 2 索引的集合，可在更新來源紀錄時維持一致檢索表示。改用其他嵌入版本應視為索引遷移，並在相同儲存庫上明確比較。
自然語言查詢中，描述操作、輸入與相關結果。程式碼查詢中，加入需要匹配邏輯的片段，並解釋對搜尋重要的條件。例如，搜尋重試處理時，可指定相關程式碼是在逾時後重試，還是在收到完整錯誤回應後重試。擷取來源用於編輯前，應先檢查這項區別。
文件與原始碼都建立索引時，應讓兩者可追溯。說明段落可能提供有用脈絡，而實作是開發者需要檢查的成品。為這些紀錄型別加上標籤，讓搜尋頁面顯示正確目的地，也讓程式設計助理區分描述與可執行原始碼。
將擷取段落作為儲存庫導覽、實作探索或程式設計助理下一步的脈絡。向下游傳遞時，保留完整相關片段及位置。相似度有助尋找候選程式碼；檢閱實際輸入、副作用與規格，才能判定候選是否解決目前問題。
使用具有已知來源答案的一組真實問題評估檢索。加入已更名函式、誤導註解、邊界情況不同的相似工具，以及使用程式碼中未出現詞彙的查詢。檢查預期實作是否出現在有用結果中，以及顯示片段是否提供足夠評估脈絡。儲存庫成長時保留這些問題，讓擷取、段落邊界或索引變更都能對照相同任務比較。
Ailoot Ultra · 嵌入向量 POST /v1/embeddings voyage-code-2
voyage-code-2入門
Voyage Code 2 將原始碼與相關文字嵌入，用於語意儲存庫搜尋。自然語言問題、程式碼片段或組合查詢可擷取相關實作；這個版本使用 16,000 個 token 的上下文視窗與 1,536 維向量。
- 接受的輸入
- 文字
- 結果
- embedding
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 嵌入向量 POST /v1/embeddings
- 輸入
text- 輸出
embedding
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 voyage-code-2 條件: 請使用完全相符的 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-2",
"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-2
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Voyage AI: Voyage Code 2
- 可以使用哪些輸入與結果？
POST /v1/embeddings·voyage-code-2:text→embedding- 請求使用哪些欄位？
POST /v1/embeddings·voyage-code-2:model,input