Mistral: Codestral Embed 2505
Codestral Embed 2505 esittää koodin ja luonnollisen kielen kyselyt vektoreina koodivarastohakuun ja koodausassistenttien tiedonhakuun. Valmistaja dokumentoi 8192 tokenin kontekstin, määritettävät ulottuvuudet enintään 3072:een sekä liukuluku-, kokonaisluku- ja bittipakatut tulosmuodot.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Codestral Embed 2505 on Mistral AI:n koodin tiedonhakuun erikoistunut upotusmalli. Se vastaanottaa lähdekoodia tai luonnollisen kielen koodikyselyn sisältävän tekstin ja palauttaa numeeriset vektorit. Valmistaja asemoi sen koodivarastohakuun, koodausassistenttien kontekstinhakuun, samankaltaisuus- ja kaksoiskappaleanalyysiin sekä koodin ryhmittelyyn toiminnallisuuden tai rakenteen mukaan. Sen kiinteä julkaisutunniste on codestral-embed-2505.
Syöte ja esitys
Koodisyöte voi olla funktio, siihen liittyvä lähdekatkelma tai muu koodivaraston merkityksellinen kokonaisuus. Luonnollisen kielen kysely voi kuvata etsittävän toiminnan nimeämättä täsmällistä symbolia. Upotus esittää syötteen vertailua varten; malli ei tuota uutta toteutusta tai suorita vastaanottamaansa koodia.
Virallinen julkaisu dokumentoi 8192 tokenin täyden syötekontekstin. Valmistaja suosittelee tiedonhakuun noin 3000 merkin paloja 1000 merkin päällekkäisyydellä ja huomauttaa suurempien palojen voivan heikentää hakua. Nämä ovat haun valmistelusuosituksia, eivät 3000 merkin tokenraja. Pidä tiedosto, symboli ja lähdesijainti kunkin valmistellun kohteen yhteydessä, jotta sovellus voi palauttaa olennaisen koodin haun jälkeen.
Tulostarkkuus ja ulottuvuudet
Koodiupotusopas dokumentoi tulostyypit float, int8, uint8, binary ja ubinary. Float käyttää 32-bittisiä yksinkertaisen tarkkuuden arvoja. Int8 käyttää etumerkillisiä 8-bittisiä kokonaislukuja väliltä -128–127 ja uint8 etumerkittömiä 8-bittisiä arvoja väliltä 0–255. Binary ja ubinary tallentavat kvantisoidut yhden bitin arvot pakattuihin 8-bittisiin alkioihin käyttäen vastaavasti etumerkillisiä tai etumerkittömiä säiliöitä.
Bittipakattu esitys muuttaa palautetun luettelon pituutta: opas kuvaa yhden pakatun alkion jokaista kahdeksaa loogista upotusulottuvuutta kohti. Muodon huomioiva vertailu eroaa siis pakattujen tavujen käsittelystä tavallisina liukulukukoordinaatteina. Säilytä valittu tyyppi vektorin yhteydessä ja käytä samaa esitystä indeksoidulle koodille ja sen kyselylle.
Parametridokumentaatio antaa oletusulottuvuudeksi 1536 ja enimmäisulottuvuudeksi 3072. Ulottuvuudet on järjestetty relevanssin mukaan, ja valmistaja kuvaa ensimmäisen valitun määrän säilyttämisen tapana valita esityskoko. Valitse ulottuvuus johdonmukaisesti tallennetulle kokoelmalle ja uusille kyselyille. Lyhyempi tai kvantisoitu esitys muuttaa tallennusta ja vertailukäyttäytymistä; se ei kasvata syötekontekstia tai muuta mallia koodigeneraattoriksi.
Haulla täydennetty koodaus
Julkaisun ensimmäinen käyttötapaus on kontekstin hakeminen koodin täydentämiseen, muokkaamiseen tai selittämiseen. Valmistele merkitykselliset koodikokonaisuudet ja säilytä koodivaraston revisio sekä lähdetunnisteet. Tietyn virheen käsittelyä koskeva kysymys voi hakea siihen liittyviä funktioita, jotka sovellus antaa sitten koodausmallille todellisen muutospyynnön kanssa.
Käytännön tulos on järjestetty lähdekatkelmien joukko, joka sisältää tiedostopolut, symbolit ja niiden toiminnan ymmärtämiseen tarvittavan sisällön. Kehittäjä voi avata haetut katkelmat tai ne voidaan välittää assistentille. Codestral Embed suorittaa esitysvaiheen; erillinen komponentti valitsee tulokset ja generointimalli kirjoittaa selityksen tai koodiehdotuksen.
Semanttinen haku ja samankaltaisuus
Valmistaja kuvaa koodin hakemista luonnollisen kielen tai koodin kyselyillä. Kehittäjä voi kysyä toiminnan toteutusta, vaikka funktion nimi eroaisi pyynnön sanamuodosta. Sisällytä tarkoitettua toteutusta erottava toiminta ja ehdot; koko alijärjestelmää koskeva yleinen kysely voi hakea toisiinsa liittyvää materiaalia ratkaisematta täsmällistä kysymystä.
Julkaisu kuvaa myös lähes identtisen tai toiminnallisesti samankaltaisen koodin löytämistä leksikaalisista eroista huolimatta. Tällaiset tulokset voivat auttaa löytämään uudelleenkäytettävän toteutuksen tai tunnistamaan lisätarkastelua tarvitsevan koodin. Samankaltaisuus upotusavaruudessa on signaali lähteen tutkimiseen; se ei osoita kahden katkelman toimivan identtisesti jokaisella syötteellä.
Ryhmittely, analytiikka ja vertailu
Koodiupotuksilla voidaan ryhmitellä koodia toiminnallisuuden tai rakenteen mukaan ja tutkia koodivaraston koostumusta. Pidä alkuperäiset katkelmat ja tunnisteet saatavilla, jotta ihminen tai myöhempi sovellusvaihe voi tulkita ryhmän. Ryhmä on esityspohjainen ryhmittely, ei automaattisesti varmennettu arkkitehtuurikuvaus.
Valmistajan liukuluvektoriesimerkit käyttävät yksikkönormiin normalisoituja upotuksia, joille kosinisamankaltaisuus, pistetulo ja euklidinen etäisyys antavat yhtenäiset järjestykset. Kvantisoidun ja bittipakatun tuloksen tulisi säilyttää oma muodon käsittelynsä sen sijaan, että se perisi raakaliukulukukoordinaatteja koskevan oletuksen. Julkaistu päätepiste säilyttää myös syöteindeksit, mikä auttaa ylläpitämään kunkin vektorin yhteyttä lähdekohteeseensa.
Versio ja käytännön rajat
Täsmällinen mallisivu listaa upotus- ja erätyönkulut 8k-kontekstimerkinnällä, ja julkaisu antaa 8192 tokenin arvon. Säilytä nimetty 2505-versio, valittu tulosulottuvuus ja tyyppi koko kokoelma- ja kyselytyönkulun läpi. Tämä on koodiin suuntautunut vektoritulos, joka eroaa Codestralin tekstintäydennyksestä ja kiinteäulotteisesta Mistral Embed -tekstimallista.
Valmistele olennaisen toiminnan sisältäviä koodikokonaisuuksia, säilytä niiden lähdesijainnit ja ilmaise etsittävä kysymys. Hyödyllinen tuotos on todelliseen koodiin liitetty haettava esitys, joka tukee seuraavaa selitys-, muokkaus- tai kehittäjätarkasteluvaihetta suorittamatta sitä itse.
Ailoot Ultra · Vektoriesitykset POST /v1/embeddings mistralai/codestral-embed-2505
mistralai/codestral-embed-2505
mistralai/codestral-embed-2505Aloitus
Codestral Embed 2505 esittää koodin ja luonnollisen kielen kyselyt vektoreina koodivarastohakuun ja koodausassistenttien tiedonhakuun. Valmistaja dokumentoi 8192 tokenin kontekstin, määritettävät ulottuvuudet enintään 3072:een sekä liukuluku-, kokonaisluku- ja bittipakatut tulosmuodot.
- Hyväksytyt syötteet
- Teksti · token_ids
- Tulokset
- embedding
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Vektoriesitykset POST /v1/embeddings
- Syötetyypit
text,token_ids- Tulostyypit
embedding- Konteksti
- 8 192 tokens
- Tulosteen muoto
- json
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat mistralai/codestral-embed-2505 | Oletus— |
Kenttäinput | Tyyppistring|string[]|integer[]|integer[][] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 Ehdot: Ei-tyhjä, yhdenmukaisista alkioista koostuva erä. Tokenien ID:t ovat ei-negatiivisia kokonaislukuja. Syötebudjetti: Enimmäismäärä: 8 192 · Tekstiyksikkö: UTF8-tavut · Tokenyksikkö: Token-taulukon alkiot | Oletus— |
Kenttäencoding_format | Tyyppistring | VaatimusValinnainen | Arvot & rajat float | Oletusfloat |
Kenttädimensions | Tyyppiinteger | VaatimusEi tuettu | Arvot & rajat Vähimmäismäärä: 1 | Oletus— |
Kenttäuser | Tyyppijson_value | VaatimusValinnainen | Arvot & rajat Ehdot: Lähde sallii tämän JSON-metatietokentän; tarkka alkuperäisen palvelun semantiikka on mallikohtainen. | Oletus— |
Kenttäsession_id | Tyyppijson_value | VaatimusValinnainen | Arvot & rajat Ehdot: Lähde sallii tämän JSON-metatietokentän; tarkka alkuperäisen palvelun semantiikka on mallikohtainen. | Oletus— |
Kenttätrace | Tyyppijson_value | VaatimusValinnainen | Arvot & rajat Ehdot: Lähde sallii tämän JSON-metatietokentän; tarkka alkuperäisen palvelun semantiikka on mallikohtainen. | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options hylätty | Oletus— |
Syöteaineistojen yhdistelmät
text_to_embedding
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, input |
Parametriinput_shapes | Sopimusstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parametriencoding_format | Sopimusfloat |
Parametridimensions_override | Sopimusfalse |
Parametrimax_input_budget_units | Sopimus8192 |
Parametrimultimodal_objects | Sopimusfalse |
Parametrimaterial_types | Sopimustext, token_ids |
Elinkaari: synchronous_json
Säilytä jokaisen vektorin indeksi ja ulottuvuus.
Mallin nimen multimodaalisuus ei tarkoita, että tämä nimenomainen reitti hyväksyisi kuvaolioita.
Hinnoittelu
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Vakiohinta Kun nopea tila on valittu
- Flex-tila
- Vakiohinta Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Vakiohinta Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Ailoot-hinnat
Hinnat asetusten mukaan
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.0003 / 1K tokenia Tuloste · Tulostokenit $0 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
Ailoot Ultra · Vektoriesitykset
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)
Vastaanota ja tallenna tulokset
Ailoot Ultra · Vektoriesitykset
json
Säilytä kaikki valmistuneet tulokset
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä jokainen vektori indekseineen. Vektorien määrän on vastattava syötteiden määrää; ulottuvuuksien on oltava yhdenmukaiset.
Jos alkuperäinen vastaus on tarkistettava
Uutta upotustehtävien päätepistettä ei oteta käyttöön.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttäobject | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttädata[].index | Tyyppiinteger |
Kenttädata[].embedding | Tyyppifinite float[] |
Kenttäusage | Tyyppiobject |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Aliakset
Mallin aliakset
Ailoot Ultra mistralai/codestral-embed-2505
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · Mistral: Codestral Embed 2505
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/embeddings·mistralai/codestral-embed-2505:text,token_ids→embedding- Mitä kenttiä pyyntö käyttää?
POST /v1/embeddings·mistralai/codestral-embed-2505:model,input,encoding_format,provider- Mitä rajoja sovelletaan?
POST /v1/embeddings·mistralai/codestral-embed-2505:ctx:8192;input.budget.maximum:8192(UTF8-tavut);input.min_items:1