voyage-code-4 je embeddingový model společnosti Voyage AI specializovaný na kód, určený pro vyhledávání v repozitářích a vyhledávání podkladů pro programovací agenty. Pomáhá najít relevantní zdrojový kód, když je výchozím bodem otázka, příznak nebo popis úkolu, nikoli známý identifikátor. Reprezentuje kód a textové informace jako číselné vektory pro vyhledávání; neupravuje repozitář ani negeneruje opravu.
Výrobce popisuje trénovací korpus sestavený z dokončených pull requestů, který propojuje dotazy v přirozeném jazyce s kódem. Jde o významný rozdíl oproti trénovacím příkladům založeným především na zdrojových souborech a jejich dokumentačních řetězcích: úloha vyhledávání může začít chováním, které je třeba prozkoumat.
Připravte dotaz například „Najděte, kde prázdný výsledek způsobí, že je úspěšná operace hlášena jako selhání“. Indexujte čitelné oddíly zdrojového kódu s cestami k souborům a příslušnými komentáři. Zachovejte podmínky kolem funkce, pokud vysvětlují její chování. Vrácený kandidát by měl čtenáře nebo agenta vést zpět k oddílu zdrojového kódu, který reprezentuje.
Sémantické vyhledávání může doplňovat vyhledávání přesných identifikátorů a plnotextové vyhledávání. Je-li název funkce již znám, přesné vyhledání zůstává užitečné. Je-li znám pouze příznak, vektorové vyhledávání může poskytnout kandidáty ke kontrole a zpřesnění dalším dotazem.
Pokyny Voyage k vyhledávání rozlišují dotaz a dokument korpusu pomocí vstupních typů query/document. Pro hledání kódu použijte popis problému nebo úkolu jako dotaz a indexovaný zdrojový kód nebo dokumentaci jako dokument. Publikovaný postup přidává při vytváření embeddingů pokyny pro vyhledávání podle konkrétní role.
Původní formátování kódu, názvy a příslušnou dokumentaci uchovávejte dostupné mimo vektor. U oddílu zdrojového kódu zachovejte cestu k souboru a umístění; u programovací příručky zachovejte nadpis. Po vyhledání prohlédněte skutečný kód a místa, která jej volají, než zvolíte úpravu. Relevance kandidáta nedokládá, že je jedinou příčinou hlášeného problému.
Publikovaná délka kontextu tohoto konkrétního modelu je 32 000 tokenů. Výchozí embedding má 1024 rozměrů; díky učení Matryoshka jsou podporovány také rozměry 256, 512 a 2048. Oznámení dokumentuje 32bitové reprezentace s plovoucí řádovou čárkou, 8bitové celočíselné reprezentace se znaménkem i bez znaménka a binární reprezentace.
Pro kolekci zvolte jediný rozměr a reprezentaci a uchovávejte je v jejích metadatech. Vektory s plovoucí řádovou čárkou a kvantované reprezentace vyžadují odpovídající zpracování při ukládání a porovnávání. Binární reprezentace kóduje informace vektoru jinak než seznam běžných souřadnic s plovoucí řádovou čárkou; při přípravě výsledků pro vyhledávání toto rozlišení zachovejte.
U dlouhého souboru volte souvislé oddíly, jejichž umístění ve zdroji lze dohledat. Funkce může k vysvětlení podmínky potřebovat sousední definici typu nebo komentář, zatímco celý příliš velký soubor může obsahovat nesouvisející materiál. Oddíl přizpůsobte úkolu, podle kterého se bude hledat, místo abyste maximální kontext považovali za preferovanou velikost úseku.
Praktický postup programovacího agenta vyhledává kandidátní zdrojový kód, čte příslušné soubory, sleduje relevantní odkazy a s postupem zkoumání zužuje hledání. Nalezený text se stává kontextem pro fázi uvažování nebo úprav. Zachovejte jeho propojení s indexovanou revizí repozitáře, aby se kandidát kontroloval vůči správnému zdroji.
Přínosem specifickým pro edici voyage-code-4 je zaměření na krok vyhledání kódu podle problému, který používají programovací agenti, společně s flexibilními rozměry a reprezentacemi. Výstupem je vektor pro vyhledávání, zatímco diagnostika, úpravy a ověřování zůstávají samostatnými úkoly založenými na skutečném repozitáři.
", "aboutText": "voyage-code-4 je embeddingový model společnosti Voyage AI specializovaný na kód, určený pro vyhledávání v repozitářích a vyhledávání podkladů pro programovací agenty. Pomáhá najít relevantní zdrojový kód, když je výchozím bodem otázka, příznak nebo popis úkolu, nikoli známý identifikátor. Reprezentuje kód a textové informace jako číselné vektory pro vyhledávání; neupravuje repozitář ani negeneruje opravu.\n\n### Vyhledávání kódu podle zkoumaného problému\n\nVýrobce popisuje trénovací korpus sestavený z dokončených pull requestů, který propojuje dotazy v přirozeném jazyce s kódem. Jde o významný rozdíl oproti trénovacím příkladům založeným především na zdrojových souborech a jejich dokumentačních řetězcích: úloha vyhledávání může začít chováním, které je třeba prozkoumat.\n\nPřipravte dotaz například „Najděte, kde prázdný výsledek způsobí, že je úspěšná operace hlášena jako selhání“. Indexujte čitelné oddíly zdrojového kódu s cestami k souborům a příslušnými komentáři. Zachovejte podmínky kolem funkce, pokud vysvětlují její chování. Vrácený kandidát by měl čtenáře nebo agenta vést zpět k oddílu zdrojového kódu, který reprezentuje.\n\nSémantické vyhledávání může doplňovat vyhledávání přesných identifikátorů a plnotextové vyhledávání. Je-li název funkce již znám, přesné vyhledání zůstává užitečné. Je-li znám pouze příznak, vektorové vyhledávání může poskytnout kandidáty ke kontrole a zpřesnění dalším dotazem.\n\n### Role dotazu a dokumentu\n\nPokyny Voyage k vyhledávání rozlišují dotaz a dokument korpusu pomocí vstupních typů query/document. Pro hledání kódu použijte popis problému nebo úkolu jako dotaz a indexovaný zdrojový kód nebo dokumentaci jako dokument. Publikovaný postup přidává při vytváření embeddingů pokyny pro vyhledávání podle konkrétní role.\n\nPůvodní formátování kódu, názvy a příslušnou dokumentaci uchovávejte dostupné mimo vektor. U oddílu zdrojového kódu zachovejte cestu k souboru a umístění; u programovací příručky zachovejte nadpis. Po vyhledání prohlédněte skutečný kód a místa, která jej volají, než zvolíte úpravu. Relevance kandidáta nedokládá, že je jedinou příčinou hlášeného problému.\n\n### Volby kontextu a reprezentace\n\nPublikovaná délka kontextu tohoto konkrétního modelu je 32 000 tokenů. Výchozí embedding má 1024 rozměrů; díky učení Matryoshka jsou podporovány také rozměry 256, 512 a 2048. Oznámení dokumentuje 32bitové reprezentace s plovoucí řádovou čárkou, 8bitové celočíselné reprezentace se znaménkem i bez znaménka a binární reprezentace.\n\nPro kolekci zvolte jediný rozměr a reprezentaci a uchovávejte je v jejích metadatech. Vektory s plovoucí řádovou čárkou a kvantované reprezentace vyžadují odpovídající zpracování při ukládání a porovnávání. Binární reprezentace kóduje informace vektoru jinak než seznam běžných souřadnic s plovoucí řádovou čárkou; při přípravě výsledků pro vyhledávání toto rozlišení zachovejte.\n\nU dlouhého souboru volte souvislé oddíly, jejichž umístění ve zdroji lze dohledat. Funkce může k vysvětlení podmínky potřebovat sousední definici typu nebo komentář, zatímco celý příliš velký soubor může obsahovat nesouvisející materiál. Oddíl přizpůsobte úkolu, podle kterého se bude hledat, místo abyste maximální kontext považovali za preferovanou velikost úseku.\n\n### Použití nalezeného zdroje jako důkazu\n\nPraktický postup programovacího agenta vyhledává kandidátní zdrojový kód, čte příslušné soubory, sleduje relevantní odkazy a s postupem zkoumání zužuje hledání. Nalezený text se stává kontextem pro fázi uvažování nebo úprav. Zachovejte jeho propojení s indexovanou revizí repozitáře, aby se kandidát kontroloval vůči správnému zdroji.\n\nPřínosem specifickým pro edici voyage-code-4 je zaměření na krok vyhledání kódu podle problému, který používají programovací agenti, společně s flexibilními rozměry a reprezentacemi. Výstupem je vektor pro vyhledávání, zatímco diagnostika, úpravy a ověřování zůstávají samostatnými úkoly založenými na skutečném repozitáři.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5623e5012fa2cf14fa14e850eaec71d50e4d853716b06970eaf95b4d0a3cd346", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "cs", "methods": [ { "html": "voyageai/voyage-code-4Voyage AI voyage-code-4 je embeddingový model pro kód, který hledá relevantní zdrojový kód podle otázek, popisů problémů a cílů programovacích agentů. Podporuje vstupy o délce 32 000 tokenů a 256, 512, 1024 nebo 2048 rozměrů s reprezentacemi s plovoucí řádovou čárkou i kvantovanými reprezentacemi.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
voyage-code-4 je embeddingový model společnosti Voyage AI specializovaný na kód, určený pro vyhledávání v repozitářích a vyhledávání podkladů pro programovací agenty. Pomáhá najít relevantní zdrojový kód, když je výchozím bodem otázka, příznak nebo popis úkolu, nikoli známý identifikátor. Reprezentuje kód a textové informace jako číselné vektory pro vyhledávání; neupravuje repozitář ani negeneruje opravu.
Výrobce popisuje trénovací korpus sestavený z dokončených pull requestů, který propojuje dotazy v přirozeném jazyce s kódem. Jde o významný rozdíl oproti trénovacím příkladům založeným především na zdrojových souborech a jejich dokumentačních řetězcích: úloha vyhledávání může začít chováním, které je třeba prozkoumat.
Připravte dotaz například „Najděte, kde prázdný výsledek způsobí, že je úspěšná operace hlášena jako selhání“. Indexujte čitelné oddíly zdrojového kódu s cestami k souborům a příslušnými komentáři. Zachovejte podmínky kolem funkce, pokud vysvětlují její chování. Vrácený kandidát by měl čtenáře nebo agenta vést zpět k oddílu zdrojového kódu, který reprezentuje.
Sémantické vyhledávání může doplňovat vyhledávání přesných identifikátorů a plnotextové vyhledávání. Je-li název funkce již znám, přesné vyhledání zůstává užitečné. Je-li znám pouze příznak, vektorové vyhledávání může poskytnout kandidáty ke kontrole a zpřesnění dalším dotazem.
Pokyny Voyage k vyhledávání rozlišují dotaz a dokument korpusu pomocí vstupních typů query/document. Pro hledání kódu použijte popis problému nebo úkolu jako dotaz a indexovaný zdrojový kód nebo dokumentaci jako dokument. Publikovaný postup přidává při vytváření embeddingů pokyny pro vyhledávání podle konkrétní role.
Původní formátování kódu, názvy a příslušnou dokumentaci uchovávejte dostupné mimo vektor. U oddílu zdrojového kódu zachovejte cestu k souboru a umístění; u programovací příručky zachovejte nadpis. Po vyhledání prohlédněte skutečný kód a místa, která jej volají, než zvolíte úpravu. Relevance kandidáta nedokládá, že je jedinou příčinou hlášeného problému.
Publikovaná délka kontextu tohoto konkrétního modelu je 32 000 tokenů. Výchozí embedding má 1024 rozměrů; díky učení Matryoshka jsou podporovány také rozměry 256, 512 a 2048. Oznámení dokumentuje 32bitové reprezentace s plovoucí řádovou čárkou, 8bitové celočíselné reprezentace se znaménkem i bez znaménka a binární reprezentace.
Pro kolekci zvolte jediný rozměr a reprezentaci a uchovávejte je v jejích metadatech. Vektory s plovoucí řádovou čárkou a kvantované reprezentace vyžadují odpovídající zpracování při ukládání a porovnávání. Binární reprezentace kóduje informace vektoru jinak než seznam běžných souřadnic s plovoucí řádovou čárkou; při přípravě výsledků pro vyhledávání toto rozlišení zachovejte.
U dlouhého souboru volte souvislé oddíly, jejichž umístění ve zdroji lze dohledat. Funkce může k vysvětlení podmínky potřebovat sousední definici typu nebo komentář, zatímco celý příliš velký soubor může obsahovat nesouvisející materiál. Oddíl přizpůsobte úkolu, podle kterého se bude hledat, místo abyste maximální kontext považovali za preferovanou velikost úseku.
Praktický postup programovacího agenta vyhledává kandidátní zdrojový kód, čte příslušné soubory, sleduje relevantní odkazy a s postupem zkoumání zužuje hledání. Nalezený text se stává kontextem pro fázi uvažování nebo úprav. Zachovejte jeho propojení s indexovanou revizí repozitáře, aby se kandidát kontroloval vůči správnému zdroji.
Přínosem specifickým pro edici voyage-code-4 je zaměření na krok vyhledání kódu podle problému, který používají programovací agenti, společně s flexibilními rozměry a reprezentacemi. Výstupem je vektor pro vyhledávání, zatímco diagnostika, úpravy a ověřování zůstávají samostatnými úkoly založenými na skutečném repozitáři.
POST /v1/embeddingstext, token_idsembedding| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity voyageai/voyage-code-4 | Výchozí— |
Poleinput | Typstring|string[]|integer[]|integer[][] | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 Podmínky: Neprázdná homogenní dávka. ID tokenů jsou nezáporná celá čísla. Rozpočet vstupu: Maximum: 32 000 · Jednotka textu: bajty UTF8 · Jednotka tokenů: prvky pole tokenů | Výchozí— |
Poleencoding_format | Typstring | PožadavekVolitelné | Hodnoty a limity float | Výchozífloat |
Poledimensions | Typinteger | PožadavekNepodporováno | Hodnoty a limity Minimum: 1 | Výchozí— |
Poleuser | Typjson_value | PožadavekVolitelné | Hodnoty a limity Podmínky: Zdroj povoluje toto pole metadat JSON; jeho přesný význam u poskytovatele závisí na konkrétním modelu. | Výchozí— |
Polesession_id | Typjson_value | PožadavekVolitelné | Hodnoty a limity Podmínky: Zdroj povoluje toto pole metadat JSON; jeho přesný význam u poskytovatele závisí na konkrétním modelu. | Výchozí— |
Poletrace | Typjson_value | PožadavekVolitelné | Hodnoty a limity Podmínky: Zdroj povoluje toto pole metadat JSON; jeho přesný význam u poskytovatele závisí na konkrétním modelu. | Výchozí— |
Poleprovider | Typobject | PožadavekVolitelné | Hodnoty a limity Podmínky: Parametr provider.options byl odmítnut | Výchozí— |
text_to_embedding
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, input |
Parametrinput_shapes | Kontraktstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parametrencoding_format | Kontraktfloat |
Parametrdimensions_override | Kontraktfalse |
Parametrmax_input_budget_units | Kontrakt32000 |
Parametrmultimodal_objects | Kontraktfalse |
Parametrmaterial_types | Kontrakttext, token_ids |
Životní cyklus: synchronous_json
Uchovejte index i rozměr každého vektoru.
Multimodální název modelu neznamená, že tato konkrétní cesta přijímá obrazové objekty.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
| Konfigurace | Tabulka sazeb | Poplatek |
|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Poplatek Vstup · Vstupní tokeny $0.00024 / 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í →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "voyageai/voyage-code-4", "input": ["First document", "Second document"]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.embeddings.create(model='voyageai/voyage-code-4',input=["First document","Second document"])\nprint(result)\nfor item in result.data:print(item.index,item.embedding)\njson
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Uchovejte každý vektor spolu s jeho indexem. Počet vektorů musí odpovídat počtu vstupů; jejich rozměr musí být jednotný.
Samostatný endpoint úloh pro embeddingy se nezavádí.
| Pole | Typ |
|---|---|
Poleobject | Typstring |
Polemodel | Typstring |
Poledata[].index | Typinteger |
Poledata[].embedding | Typfinite float[] |
Poleusage | Typobject |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Ailoot Ultra voyageai/voyage-code-4
Použijte cesty metod uvedené výše.