Mistral: Codestral Embed 2505
Codestral Embed 2505 kodo in poizvedbe v naravnem jeziku predstavi kot vektorje za iskanje po repozitorijih in pridobivanje konteksta za programske asistente. Proizvajalec dokumentira kontekst 8192 žetonov, nastavljive razsežnosti do 3072 ter izhodne formate s plavajočo vejico, cela števila ali bitno pakirane vrednosti.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Codestral Embed 2505 je model embeddingov Mistral AI, specializiran za pridobivanje kode. Prejme besedilo z izvorno kodo ali poizvedbo o kodi v naravnem jeziku in vrne številčne vektorje. Proizvajalec ga umešča v iskanje po repozitorijih, pridobivanje konteksta za programske asistente, analizo podobnosti in dvojnikov ter združevanje kode po funkcionalnosti ali strukturi. Njegov fiksni identifikator izdaje je codestral-embed-2505.
Vhod in predstavitev
Vhod s kodo je lahko funkcija, povezan izvorni fragment ali druga smiselna enota repozitorija. Poizvedba v naravnem jeziku lahko opiše iskano vedenje, ne da poimenuje točen simbol. Embedding ta vhod predstavlja za primerjavo; model ne generira nove implementacije in ne izvede prejete kode.
Uradna izdaja dokumentira polni vhodni kontekst 8192 žetonov. Za pridobivanje proizvajalec priporoča dele s približno 3000 znaki in prekrivanjem 1000 znakov ter opozarja, da večji deli lahko poslabšajo iskanje. To so priporočila za pripravo pridobivanja, ne žetonska omejitev 3000 znakov. Datoteko, simbol in mesto vira ohranite povezana z vsakim pripravljenim elementom, da aplikacija po iskanju lahko vrne relevantno kodo.
Natančnost in razsežnosti izhoda
Vodnik za embeddinge kode dokumentira izhodne tipe float, int8, uint8, binary in ubinary. Float uporablja 32-bitne vrednosti enojne natančnosti. Int8 uporablja 8-bitna cela števila s predznakom od -128 do 127, uint8 pa 8-bitne vrednosti brez predznaka od 0 do 255. Binary in ubinary kvantizirane enobitne vrednosti hranita v pakiranih 8-bitnih elementih, prvi v vsebnikih s predznakom, drugi brez predznaka.
Bitno pakirana predstavitev spremeni dolžino vrnjenega seznama: vodnik opisuje en pakirani element na vsakih osem logičnih razsežnosti embeddinga. Primerjava z upoštevanjem formata se zato razlikuje od obravnave pakiranih bajtov kot običajnih koordinat s plavajočo vejico. Izbrani tip ohranite z vektorjem in za indeksirano kodo ter njeno poizvedbo uporabite isto predstavitev.
Dokumentacija parametrov navaja privzeto razsežnost 1536 in največjo 3072. Razsežnosti so razvrščene po relevantnosti, proizvajalec pa opisuje ohranitev izbranega števila prvih razsežnosti kot način izbire velikosti predstavitve. Razsežnost izberite dosledno za shranjeno zbirko in nove poizvedbe. Krajša ali kvantizirana predstavitev spremeni shranjevanje in primerjavo; ne poveča vhodnega konteksta in modela ne spremeni v generator kode.
Programiranje z uporabo rezultatov iskanja
Prvi primer uporabe izdaje je pridobivanje konteksta za dopolnjevanje, urejanje ali pojasnjevanje kode. Pripravite smiselne enote kode in ohranite revizijo repozitorija ter identifikatorje virov. Vprašanje o obravnavi konkretne napake lahko pridobi povezane funkcije, ki jih aplikacija nato poda programskemu modelu skupaj z dejansko zahtevo za spremembo.
Praktičen rezultat je razvrščen nabor izvornih izsekov s potmi datotek, simboli in vsebino, potrebno za razumevanje njihovega vedenja. Pridobljene izseke lahko odpre razvijalec ali jih prejme asistent. Codestral Embed izvede korak predstavitve; ločena komponenta izbere rezultate, generativni model pa napiše razlago ali predlagano kodo.
Semantično iskanje in podobnost
Proizvajalec opisuje iskanje kode s poizvedbami v naravnem jeziku ali kodi. Razvijalec lahko zahteva implementacijo vedenja, tudi če se ime funkcije razlikuje od besedila zahteve. Vključite vedenje in pogoje, ki razločujejo predvideno implementacijo; splošna poizvedba o celotnem podsistemu lahko pridobi povezano gradivo, ne da razreši konkretno vprašanje.
Izdaja opisuje tudi iskanje skoraj podvojene ali funkcionalno podobne kode kljub leksikalnim razlikam. Takšni rezultati lahko pomagajo najti ponovno uporabno implementacijo ali prepoznati kodo za nadaljnji pregled. Podobnost v prostoru embeddingov je signal za pregled vira; ne dokazuje enakega vedenja dveh fragmentov za vsak vhod.
Gručenje, analitika in primerjava
Embeddingi kode lahko služijo združevanju kode po funkcionalnosti ali strukturi ter pregledu sestave repozitorija. Izvirne izseke in identifikatorje ohranite na voljo, da skupino lahko interpretira človek ali poznejši aplikacijski korak. Gruča je skupina na podlagi predstavitve, ne samodejno preverjeni opis arhitekture.
Proizvajalčevi primeri z vektorji s plavajočo vejico uporabljajo embeddinge, normalizirane na enotsko normo, pri katerih kosinusna podobnost, skalarni produkt in evklidska razdalja dajejo skladne razvrstitve. Kvantizirani in bitno pakirani izhod naj ohrani lastno obravnavo formata, ne prevzema predpostavke o surovih koordinatah s plavajočo vejico. Objavljena končna točka ohrani tudi indekse vhodov, kar pomaga ohraniti povezavo med vsakim vektorjem in izvornim elementom.
Izdaja in praktične meje
Stran konkretnega modela navaja poteke embeddingov in paketne obdelave z oznako konteksta 8k, izdaja pa poda vrednost 8192 žetonov. Poimenovano izdajo 2505, izbrano razsežnost in tip izhoda ohranite skozi celoten potek zbirke in poizvedb. To je vektorski izhod za kodo, ločen od dopolnjevanja besedila Codestral in besedilnega modela Mistral Embed s fiksno razsežnostjo.
Pripravite enote kode z relevantnim vedenjem, ohranite njihova mesta v viru in navedite vprašanje o tem, kaj najti. Uporaben artefakt je pridobljiva predstavitev, povezana z dejansko kodo, ki podpira naslednji korak razlage, urejanja ali razvijalčevega pregleda, ne da ta korak izvede sama.
Ailoot Ultra · Vektorske predstavitve POST /v1/embeddings mistralai/codestral-embed-2505
mistralai/codestral-embed-2505
mistralai/codestral-embed-2505Začetek
Codestral Embed 2505 kodo in poizvedbe v naravnem jeziku predstavi kot vektorje za iskanje po repozitorijih in pridobivanje konteksta za programske asistente. Proizvajalec dokumentira kontekst 8192 žetonov, nastavljive razsežnosti do 3072 ter izhodne formate s plavajočo vejico, cela števila ali bitno pakirane vrednosti.
- Dovoljeni vhodi
- Besedilo · token_ids
- Rezultati
- embedding
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Vektorske predstavitve POST /v1/embeddings
- Vhod
text,token_ids- Izhod
embedding- Kontekst
- 8192 tokens
- Izhodni format
- json
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve mistralai/codestral-embed-2505 | Privzeto— |
Poljeinput | Vrstastring|string[]|integer[]|integer[][] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 Pogoji: Neprazen paket istovrstnih vhodnih podatkov. Identifikatorji žetonov so nenegativna cela števila. Vhodni proračun: Največ: 8192 · Besedilna enota: bajti UTF8 · Enota žetonov: elementi polja žetonov | Privzeto— |
Poljeencoding_format | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve float | Privzetofloat |
Poljedimensions | Vrstainteger | ZahtevaNi podprto | Vrednosti in omejitve Najmanj: 1 | Privzeto— |
Poljeuser | Vrstajson_value | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Izvor dovoljuje to polje metapodatkov JSON; natančen pomen pri ponudniku je odvisen od modela. | Privzeto— |
Poljesession_id | Vrstajson_value | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Izvor dovoljuje to polje metapodatkov JSON; natančen pomen pri ponudniku je odvisen od modela. | Privzeto— |
Poljetrace | Vrstajson_value | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Izvor dovoljuje to polje metapodatkov JSON; natančen pomen pri ponudniku je odvisen od modela. | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: provider.options je zavrnjen | Privzeto— |
Kombinacije vhodnih gradiv
text_to_embedding
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, input |
Parameterinput_shapes | Specifikacijastring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Specifikacijafloat |
Parameterdimensions_override | Specifikacijafalse |
Parametermax_input_budget_units | Specifikacija8192 |
Parametermultimodal_objects | Specifikacijafalse |
Parametermaterial_types | Specifikacijatext, token_ids |
Življenjski cikel: synchronous_json
Shranite indeks in dimenzijo vsakega vektorja.
Ime multimodalnega modela ne pomeni, da so na tej točno določeni poti dovoljeni slikovni objekti.
Cenik
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Standardna tarifa Ko je izbran hitri način
- Način flex
- Standardna tarifa Ko je izbran način flex
- Najvišja raven razmišljanja
- Standardna tarifa Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Cene Ailoot
Cene po nastavitvah
| Nastavitev | Cenovna lestvica | Strošek |
|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Strošek Vhod · Vhodni žetoni $0.0003 / 1K žetonov Izhod · Izhodni žetoni $0 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot Ultra · Vektorske predstavitve
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)
Prejmi in shrani rezultate
Ailoot Ultra · Vektorske predstavitve
json
Ohrani vse dokončane rezultate
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Shranite vsak vektor skupaj z njegovim indeksom. Število vektorjev mora biti enako številu vhodov; dimenzije morajo biti skladne.
Če je treba preveriti izvirni odgovor
Končna točka za opravila ustvarjanja vektorskih predstavitev se ne uvaja.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljeobject | Vrstastring |
Poljemodel | Vrstastring |
Poljedata[].index | Vrstainteger |
Poljedata[].embedding | Vrstafinite float[] |
Poljeusage | Vrstaobject |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Druga imena
Druga imena modelov
Ailoot Ultra mistralai/codestral-embed-2505
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · Mistral: Codestral Embed 2505
- Kateri vhodi in rezultati so na voljo?
POST /v1/embeddings·mistralai/codestral-embed-2505:text,token_ids→embedding- Katera polja uporablja zahteva?
POST /v1/embeddings·mistralai/codestral-embed-2505:model,input,encoding_format,provider- Katere omejitve veljajo?
POST /v1/embeddings·mistralai/codestral-embed-2505:ctx:8192;input.budget.maximum:8192(bajti UTF8);input.min_items:1