Mistral: Codestral Embed 2505
Codestral Embed 2505 reprezentuje kód a dopyty v prirodzenom jazyku ako vektory na vyhľadávanie v repozitároch a získavanie kontextu pre programovacích asistentov. Výrobca dokumentuje kontext 8192 tokenov, konfigurovateľné rozmery do 3072 a výstupné formáty s pohyblivou rádovou čiarkou, celočíselné alebo bitovo zbalené.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Codestral Embed 2505 je model embeddingov od Mistral AI špecializovaný na vyhľadávanie kódu. Prijíma text obsahujúci zdrojový kód alebo dopyt o kóde v prirodzenom jazyku a vracia číselné vektory. Výrobca ho určuje na vyhľadávanie v repozitároch, získavanie kontextu pre programovacích asistentov, analýzu podobnosti a duplicít a zoskupovanie kódu podľa funkcionality alebo štruktúry. Jeho pevný identifikátor vydania je codestral-embed-2505.
Vstup a reprezentácia
Vstupom kódu môže byť funkcia, súvisiaci zdrojový fragment alebo iná zmysluplná jednotka repozitára. Dopyt v prirodzenom jazyku môže opisovať hľadané správanie namiesto pomenovania presného symbolu. Embedding reprezentuje tento vstup na porovnávanie; model negeneruje novú implementáciu ani nevykonáva prijatý kód.
Oficiálne vydanie dokumentuje plný vstupný kontext 8192 tokenov. Na vyhľadávanie výrobca odporúča časti s približne 3000 znakmi a prekrytím 1000 znakov a upozorňuje, že väčšie časti môžu vyhľadávanie zhoršiť. Ide o odporúčania na prípravu vyhľadávania, nie o tokenový limit 3000 znakov. S každou pripravenou položkou zachovajte súbor, symbol a umiestnenie zdroja, aby aplikácia mohla po vyhľadaní vrátiť príslušný kód.
Presnosť a rozmery výstupu
Príručka embeddingov kódu dokumentuje výstupné typy float, int8, uint8, binary a ubinary. Float používa 32-bitové hodnoty s jednoduchou presnosťou. Int8 používa 8-bitové celé čísla so znamienkom od -128 do 127, zatiaľ čo uint8 používa 8-bitové hodnoty bez znamienka od 0 do 255. Binary a ubinary ukladajú kvantované jednobitové hodnoty do zbalených 8-bitových prvkov; používajú pritom kontajnery so znamienkom, respektíve bez znamienka.
Bitovo zbalená reprezentácia mení dĺžku vráteného zoznamu: príručka opisuje jeden zbalený prvok na každých osem logických rozmerov embeddingu. Porovnávanie zohľadňujúce formát sa preto líši od považovania zbalených bajtov za bežné súradnice s pohyblivou rádovou čiarkou. Zvolený typ zachovajte s vektorom a pre indexovaný kód aj jeho dopyt používajte rovnakú reprezentáciu.
Dokumentácia parametrov uvádza predvolený rozmer 1536 a maximum 3072. Rozmery sú zoradené podľa relevantnosti a výrobca opisuje ponechanie zvoleného počtu prvých rozmerov ako spôsob výberu veľkosti reprezentácie. Rozmer vyberajte konzistentne pre uloženú kolekciu aj nové dopyty. Kratšia alebo kvantovaná reprezentácia mení uloženie a správanie porovnávania; nezväčšuje vstupný kontext ani nemení model na generátor kódu.
Programovanie rozšírené o vyhľadávanie
Prvým prípadom použitia vo vydaní je získavanie kontextu na dopĺňanie, úpravu alebo vysvetlenie kódu. Pripravte zmysluplné jednotky kódu a zachovajte revíziu repozitára a identifikátory zdrojov. Otázka o spracovaní konkrétnej chyby môže vyhľadať súvisiace funkcie, ktoré aplikácia potom poskytne programovaciemu modelu spolu so skutočnou požiadavkou na zmenu.
Praktickým výsledkom je zoradený súbor zdrojových úryvkov s cestami k súborom, symbolmi a obsahom potrebným na pochopenie ich správania. Vyhľadané úryvky môže otvoriť vývojár alebo ich možno odovzdať asistentovi. Codestral Embed vykonáva krok reprezentácie; samostatný komponent vyberá výsledky a generatívny model píše vysvetlenie alebo navrhovaný kód.
Sémantické vyhľadávanie a podobnosť
Výrobca opisuje vyhľadávanie kódu pomocou dopytov v prirodzenom jazyku alebo v kóde. Vývojár môže žiadať implementáciu správania, aj keď sa názov funkcie líši od znenia požiadavky. Zahrňte správanie a podmienky, ktoré rozlišujú zamýšľanú implementáciu; všeobecný dopyt na celý podsystém môže vyhľadať súvisiaci materiál bez zodpovedania konkrétnej otázky.
Vydanie tiež opisuje hľadanie takmer duplicitného alebo funkčne podobného kódu napriek lexikálnym rozdielom. Takéto výsledky môžu pomôcť nájsť opätovne použiteľnú implementáciu alebo určiť kód vyžadujúci ďalšiu kontrolu. Podobnosť v priestore embeddingov je signálom na preskúmanie zdroja; nepreukazuje totožné správanie dvoch fragmentov pre každý vstup.
Zhlukovanie, analytika a porovnávanie
Embeddingy kódu možno používať na zoskupovanie kódu podľa funkcionality alebo štruktúry a na skúmanie zloženia repozitára. Pôvodné úryvky a identifikátory ponechajte dostupné, aby skupinu mohol interpretovať človek alebo neskorší krok aplikácie. Zhluk je zoskupenie založené na reprezentácii, nie automaticky overený opis architektúry.
Príklady výrobcu s vektormi s pohyblivou rádovou čiarkou používajú embeddingy normalizované na jednotkovú normu, pri ktorých kosínusová podobnosť, skalárny súčin a euklidovská vzdialenosť dávajú konzistentné poradie. Kvantovaný a bitovo zbalený výstup má zachovať vlastné spracovanie formátu namiesto preberania predpokladu o surových súradniciach s pohyblivou rádovou čiarkou. Zverejnený koncový bod tiež zachováva indexy vstupov, čo pomáha uchovať prepojenie každého vektora so zdrojovou položkou.
Edícia a praktické hranice
Presná stránka modelu uvádza postupy embeddingov a dávkového spracovania s označením kontextu 8k, zatiaľ čo vydanie uvádza hodnotu 8192 tokenov. Pomenovanú edíciu 2505, zvolený výstupný rozmer a typ zachovajte v celom postupe kolekcie a dopytov. Ide o vektorový výstup orientovaný na kód, odlišný od dopĺňania textu Codestral aj od textového modelu Mistral Embed s pevným rozmerom.
Pripravte jednotky kódu nesúce relevantné správanie, zachovajte ich umiestnenie v zdroji a uveďte otázku určujúcu, čo treba nájsť. Užitočným artefaktom je vyhľadateľná reprezentácia prepojená so skutočným kódom, ktorá podporuje ďalší krok vysvetľovania, úpravy alebo vývojárskej kontroly bez vykonávania tohto kroku.
Ailoot Ultra · Embeddingy POST /v1/embeddings mistralai/codestral-embed-2505
mistralai/codestral-embed-2505
mistralai/codestral-embed-2505Úvod
Codestral Embed 2505 reprezentuje kód a dopyty v prirodzenom jazyku ako vektory na vyhľadávanie v repozitároch a získavanie kontextu pre programovacích asistentov. Výrobca dokumentuje kontext 8192 tokenov, konfigurovateľné rozmery do 3072 a výstupné formáty s pohyblivou rádovou čiarkou, celočíselné alebo bitovo zbalené.
- Povolené vstupy
- Text · token_ids
- Výsledky
- embedding
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Embeddingy POST /v1/embeddings
- Vstup
text,token_ids- Výstup
embedding- Kontext
- 8 192 tokens
- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity mistralai/codestral-embed-2505 | Predvolené— |
Poleinput | Typstring|string[]|integer[]|integer[][] | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 Podmienky: Neprázdna homogénna dávka. ID tokenov sú nezáporné celé čísla. Vstupný rozpočet: Maximum: 8 192 · Textová jednotka: bajty UTF8 · Jednotka tokenov: prvky poľa tokenov | Predvolené— |
Poleencoding_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity float | Predvolenéfloat |
Poledimensions | Typinteger | PožiadavkaNepodporované | Hodnoty a limity Minimum: 1 | Predvolené— |
Poleuser | Typjson_value | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Zdroj povoľuje toto pole metadát vo formáte JSON; presný význam na strane dodávateľa sa líši podľa modelu. | Predvolené— |
Polesession_id | Typjson_value | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Zdroj povoľuje toto pole metadát vo formáte JSON; presný význam na strane dodávateľa sa líši podľa modelu. | Predvolené— |
Poletrace | Typjson_value | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Zdroj povoľuje toto pole metadát vo formáte JSON; presný význam na strane dodávateľa sa líši podľa modelu. | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: provider.options sa odmieta | Predvolené— |
Kombinácie vstupných podkladov
text_to_embedding
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, input |
Parameterinput_shapes | Špecifikáciastring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Špecifikáciafloat |
Parameterdimensions_override | Špecifikáciafalse |
Parametermax_input_budget_units | Špecifikácia8192 |
Parametermultimodal_objects | Špecifikáciafalse |
Parametermaterial_types | Špecifikáciatext, token_ids |
Životný cyklus: synchronous_json
Uchovajte každý index a rozmer vektora.
Názov multimodálneho modelu neznamená, že na tejto konkrétnej trase možno použiť objekty obrázkov.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Štandardná sadzba Keď je zvolený rýchly režim
- Režim Flex
- Štandardná sadzba Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Štandardná sadzba Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
| Konfigurácia | Sadzobník | Poplatok |
|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Poplatok Vstup · Vstupné tokeny $0.0003 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Embeddingy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "mistralai/codestral-embed-2505", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='mistralai/codestral-embed-2505',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Prijať a uložiť výsledky
Ailoot Ultra · Embeddingy
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Uchovajte každý vektor spolu s jeho indexom. Počet vektorov sa musí rovnať počtu vstupov; rozmery musia byť konzistentné.
Ak treba overiť pôvodnú odpoveď
Nezavádza sa žiadny koncový bod pre úlohy tvorby embeddingov.
Polia odpovede
| Pole | Typ |
|---|---|
Poleobject | Typstring |
Polemodel | Typstring |
Poledata[].index | Typinteger |
Poledata[].embedding | Typfinite float[] |
Poleusage | Typobject |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Aliasy
Aliasy modelov
Ailoot Ultra mistralai/codestral-embed-2505
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Mistral: Codestral Embed 2505
- Aké vstupy a výsledky sú dostupné?
POST /v1/embeddings·mistralai/codestral-embed-2505:text,token_ids→embedding- Aké polia používa požiadavka?
POST /v1/embeddings·mistralai/codestral-embed-2505:model,input,encoding_format,provider- Aké limity platia?
POST /v1/embeddings·mistralai/codestral-embed-2505:ctx:8192;input.budget.maximum:8192(bajty UTF8);input.min_items:1