Voyage AI: Voyage Code 3
Voyage Code 3 vytváří embeddingy pro vyhledávání text–kód, kód–kód a docstring–kód. Okno 32 000 tokenů, volitelné rozměry vektorů a kvantovaný výstup podporují hledání v repozitáři a výběr kontextu kódu pro programovací asistenty.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Voyage Code 3 je model embeddingů specializovaný na vyhledávání zdrojového kódu. Výrobce popisuje úlohy přirozený jazyk–kód, kód–kód a docstring–kód: otázka může najít implementaci, část kódu může najít související logiku a popis funkce může určit relevantní kód. Model vytváří vektory pro vyhledávání, nikoli upravený soubor nebo dokončený program.
Připravte materiál repozitáře podle smysluplných jednotek kódu. Zachovejte funkci s názvem, signaturou a komentáři vysvětlujícími její účel. U větší komponenty zahrňte blízké definice potřebné k pochopení operace. Repozitář, revizi, cestu souboru a umístění řádku ukládejte samostatně, aby výsledek hledání otevřel přesný zdroj, ze kterého vznikl embedding.
Vyhledávání v přirozeném jazyce může popsat chování, například hledání části projektu, která ověřuje nahraný obsah před uložením. Kódový dotaz může dodat funkci, jejíž účel je třeba najít jinde. Vybírejte reprezentativní hledání ze skutečných vývojářských úloh včetně neznámého názvosloví, podobných implementací a pomocných nástrojů, jejichž význam závisí na okolním kódu.
Kontextové okno 32 000 tokenů pojme rozsáhlé pasáže kódu. Používejte tento prostor vědomě: úplná funkce a její relevantní závislosti mohou přinést více informací než libovolný blok přerušený uprostřed toku řízení. Zachovejte čitelné formátování zdroje a při extrakci ponechte syntaxi jazyka. Pokud je zdrojový soubor větší než vstupní okno, rozdělte jej na užitečných strukturálních hranicích a uchovejte vztah pasáží k jejich nadřazenému souboru.
Voyage Code 3 podporuje embeddingy s 2 048, 1 024, 512 nebo 256 rozměry společně s reprezentacemi s plovoucí desetinnou čárkou, osmibitovými se znaménkem nebo bez znaménka a binárními. Tyto ovládací prvky podporují různé velikosti indexu repozitáře a konfigurace hledání. Kompaktní reprezentaci vyhodnocujte pomocí stejných skutečných hledání jako větší výchozí reprezentaci a kontrolujte, zda správná funkce nebo soubor zůstává mezi užitečnými výsledky.
Pro programovacího asistenta nejprve vyhledejte relevantní zdrojové pasáže a poté je s odkazy na soubory předejte komponentě odpovědné za odpověď nebo změnu. Shoda podobnosti pomáhá vybrat kontext; nepotvrzuje zaměnitelnost dvou implementací. Před použitím nalezeného kódu k vedení úpravy prozkoumejte jeho vstupy, vedlejší účinky a okolní kontrakty.
Oddělujte nesouvisející verze repozitáře pomocí metadat a zachovejte dohledatelnost indexovaných revizí. Pokud se funkce přesune nebo změní chování, aktualizujte vektor i zdrojové umístění. Stejná nastavení embeddingů mají popisovat indexovaný zdroj i jeho dotazy. Při migraci indexu porovnávejte výsledky s existující sadou otázek, aby změna modelu nebo vektorové reprezentace tiše nezměnila kód, který vývojář vidí.
Užitečné kontroly zahrnují to, zda dotaz najde skutečnou implementaci místo pouhého názvu testu, zda docstring najde odpovídající funkci a zda je sémanticky související kód odlišen od povrchně podobného fragmentu. Ponechte vrácený zdrojový text a umístění ve výsledku hledání, aby vývojáři mohli prozkoumat důkazy. Tím se embeddingy modelu zaměřené na kód mění v praktický nástroj navigace a výběru kontextu.
Ailoot Ultra · Vektorové reprezentace POST /v1/embeddings voyage-code-3
voyage-code-3Úvod
Voyage Code 3 vytváří embeddingy pro vyhledávání text–kód, kód–kód a docstring–kód. Okno 32 000 tokenů, volitelné rozměry vektorů a kvantovaný výstup podporují hledání v repozitáři a výběr kontextu kódu pro programovací asistenty.
- Přijímané vstupy
- Text
- Výsledky
- embedding
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Vektorové reprezentace POST /v1/embeddings
- Vstup
text- Výstup
embedding
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity voyage-code-3 Podmínky: Použijte přesný identifikátor modelu Ailoot. | Výchozí— |
Poleinput | Typstring or array<string> | PožadavekPovinné | Hodnoty a limity Podmínky: Text nebo seznam textů; pro každou vrácenou datovou položku uchovejte jeden vektor i její index. | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, input |
Parametroptional | Kontrakt |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktOdešlete text s vybraným modelem; uchovejte každý vrácený vektor a jeho index. |
Životní cyklus: synchronous
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Sazby Ailoot
Ceny podle konfigurace
| Konfigurace | Tabulka sazeb | Poplatek |
|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Poplatek Vstup · Vstupní tokeny $0.0004 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Vektorové reprezentace
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.
Přijímání a ukládání výsledků
Aliasy
Aliasy modelu
Ailoot Ultra voyage-code-3
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Voyage AI: Voyage Code 3
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/embeddings·voyage-code-3:text→embedding- Jaká pole požadavek používá?
POST /v1/embeddings·voyage-code-3:model,input