DeepSeek: DeepSeek V3.1
DeepSeek V3.1 on hybriditekstimalli, joka tarjoaa ajattelutilan ja suoran vastaustilan samassa versiossa. Sen 128K-konteksti ja parannettu työkalukäyttöprofiili tukevat ohjelmointia, asiakirja-analyysia ja sovelluksen tarjoamaa hakua. Tuloksena on tekstiä tai ehdotettuja työkalukutsuja.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
DeepSeek V3.1 on DeepSeekin hybriditekstimalli: sama nimetty versio tukee ajattelua käyttäviä ja ilman ajattelua tuotettuja vastauksia keskustelumallipohjan eri asetuksilla. Valmistaja korostaa parantunutta työkalukäyttöä, agenttitehtäviä ja päättelyn tehokkuutta aiempaan malliin verrattuna. Se vastaanottaa kirjallisia ohjeita ja tekstikontekstia ja tuottaa vastauksen, koodia tai työkalukutsun sisältöä. Alkuperäinen V3.1-tunniste on erillinen Terminuksesta, V3.2:sta ja V4-perheestä.
Mallikortti ilmoittaa sekä pohja- että jälkikoulutetuille versioille yhteensä 671 miljardia parametria, 37 miljardia aktiivista parametria ja 128K-kontekstin. V3.1 rakentuu alkuperäiselle V3-pohjalle, jota koulutetaan lisää pitkillä asiakirjoilla ennen jälkikoulutusta. Sen mixture-of-experts- ja latentti attention -rakenne noudattaa V3-arkkitehtuuria. Nämä suunnittelutiedot selittävät pitkän kontekstin tekstiprofiilin muuttamatta kontekstilukua erilliseksi tulosteen enimmäismääritykseksi.
Ilman ajattelua toimiva tila valmistelee suoran vastauksen, kun taas ajattelutila aloittaa päättelyvaiheen ennen vastausta. Valmistajan mallipohja käyttää ajattelun sulkevaa merkkiä suorissa vastauksissa ja avaavaa merkkiä nykyisessä päättelyvuorossa. Monivuoroisessa keskustelussa aiempi päättelysisältö poistetaan, mutta lopulliset vastaukset ja sulkeva merkki säilyvät kontekstissa. Tämä on alkuperäisen V3.1:n historiasääntö, joka eroaa myöhemmästä V3.2:n säännöstä, jossa päättely säilytetään työkaluihin liittyvien viestien yli.
Tavanomaiset työkalukutsut on dokumentoitu ilman ajattelua toimivassa tilassa. Sovellus antaa funktioiden nimet, kuvaukset ja parametriskeemat; malli palauttaa valitun työkalun nimen ja JSON-argumentit valmistajan työkalukutsuesityksessä. Sovellus suorittaa toiminnon ja palauttaa sen tuloksen. Anna työkaluille täsmälliset tarkoitukset ja pidä palautunut havainto yhteydessä kutsuun, jotta mallin seuraavalla vaiheella on näyttöä eikä pelkkä oletus toiminnon tapahtumisesta.
Ajattelutilan haku käyttää erillistä erikoistunutta hakuagenttimuotoa. DeepSeek dokumentoi käyttäjän tarjoaman hakutyökalun ulkoista tai ajankohtaista tietoa vaativiin kysymyksiin sekä useiden keskusteluvuorojen aikana toistuvat kutsut ja havainnot. Haku on siten osa ympäröivää työnkulkua eikä väite siitä, että tekstivastaus olisi itsenäisesti selannut verkkoa. Määritä kysymys, lähdekriteerit ja tarvitsemasi lopullinen vastaus ennen hakutehtävän alkamista.
Anna ohjelmointitehtävään olennainen katkelma tai tiedostot, havaittu toiminta, odotettu toiminta ja säilytettävät rajoitteet. Havainnollistava tehtävänanto on: ”Tunnista tämän virheen syy annetulla syötteellä, ehdota rajattu korjaus ja selitä ehto, jonka muutos käsittelee.” Merkitse asiakirjatehtävässä lähdeosiot ja pyydä vertailu nimenomaisia vaatimuksia vasten. Vaadi lopullista vastausta erottamaan lähteiden tukema päätelmä ehdotetusta seuraavasta toimesta.
Valmistaja kouluttaa V3.1:n käyttäen UE8M0 FP8 -skaalausmuotoa painoille ja aktivaatioille. Sen paikalliset suositukset nimeävät myös tarkkuusherkkiä parametreja, jotka on käsiteltävä oikein. Nämä ovat julkaistun valmistajan viitteen ominaisuuksia eivätkä väite jokaisen sovelluksen valitusta tarkkuudesta tai toteutuksesta. Johdannainen, kvantisoitu versio ja myöhempi Terminus-tarkistuspiste pysyvät erillisinä valintoina alkuperäisestä nimetystä V3.1-versiosta.
Valmistele pidempi työ selkeän kysymyksen, lähdemerkintöjen ja määritellyn lopputuotoksen avulla. Sovita keskustelu, lähdeteksti, päättely ja tuloste dokumentoidun kontekstin rajoihin ja säilytä vain olennainen näyttö tehtävän kasvaessa. Määritä agentille sallitut toimet ja kriteeri, joka merkitsee tuloksen valmistuneeksi. Hyödyllinen tuotos on arvioitava tekstivastaus, koodiehdotus tai lähteiden tukema analyysi, joka liittyy syötteeseen ja sovelluksen tosiasiallisesti palauttamiin havaintoihin.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions deepseek-v3.1-thinking
deepseek-v3.1-thinkingAloitus
DeepSeek V3.1 on hybriditekstimalli, joka tarjoaa ajattelutilan ja suoran vastaustilan samassa versiossa. Sen 128K-konteksti ja parannettu työkalukäyttöprofiili tukevat ohjelmointia, asiakirja-analyysia ja sovelluksen tarjoamaa hakua. Tuloksena on tekstiä tai ehdotettuja työkalukutsuja.
- Hyväksytyt syötteet
- Teksti
- Tulokset
- Teksti
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- Syötetyypit
text- Tulostyypit
text- Tulosteen muoto
- json tai SSE
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat deepseek-v3.1-thinking | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Tekstikeskustelu | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Syöteaineistojen yhdistelmät
Teksti · UTF8-teksti
messages[].content
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages |
Parametrimaterial_types | Sopimustext |
Parametrimessages | Sopimusviestitaulukko role/content-rakenteella |
Parametrifile_material | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä |
Parametrioptional_controls | Sopimusstream |
Parametricontrol_scope | SopimusTekstikeskustelu; stream on totuusarvo, jonka oletus on false. |
Parametrioutput_modalities | Sopimustext |
Parametrihosted_operations | Sopimusfalse |
Parametrimultimodal_input_binding | Sopimusnull |
Menetelmien aliakset: /chat/completions
Elinkaari: synchronous_or_streamed
Lähetä mallin täsmällinen ID yhdessä messages-kentän kanssa.
Kontekstin pituus ei ole tuloksen yläraja.
Tekstitiedosto voi antaa tekstiä sellaisenaan; kuva-, ääni- ja tiedosto-objektisyötteet tarvitsevat täsmällisen sidonnan.
Hinnoittelu
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty 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.000572 / 1K tokenia Tuloste · Tulostokenit $0.0023 / 1K tokenia Syöte · Välimuistin luku $0 / 1K tokenia Syöte · Välimuistiin kirjoitus $0 / 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 · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"deepseek-v3.1-thinking","messages":[{"role":"user","content":"hello"}],"stream":false}')
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/chat/completions \
-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("choices",[]):
if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model="deepseek-v3.1-thinking", messages=[{"role":"user","content":"hello"}], stream=False)
import base64, json
from pathlib import Path
def save_result(data, stem="result"):
# Keep every field, including usage, IDs, reasoning and tool requests.
Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
def save_blob(encoded, suffix, label):
raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
file = Path(stem + "-" + label + "." + ext)
file.write_bytes(raw)
print("Saved", file)
for index, block in enumerate(data.get("content") or []):
print("Content", index, json.dumps(block, ensure_ascii=False))
for choice in data.get("choices") or []:
print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
for index, item in enumerate(data.get("output") or []):
print("Output", index, json.dumps(item, ensure_ascii=False))
if item.get("type") == "image_generation_call" and item.get("result"):
save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
for ci, candidate in enumerate(data.get("candidates") or []):
for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
blob = part.get("inlineData") or part.get("inline_data")
if blob and blob.get("data"):
mime = blob.get("mimeType") or blob.get("mime_type")
suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))
save_result(result.to_dict(mode="json"))
Vastaanota ja tallenna tulokset
Ailoot Ultra · OpenAI Chat
json tai SSE
Säilytä kaikki valmistuneet tulokset
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä jokainen vastausvaihtoehto sisältöineen, työkalukutsuineen ja päättelyineen. Kokoa SSE:ssä muutokset vastausvaihtoehdon ja työkalun indeksin mukaan ja säilytä lopullinen päättymissyy sekä käyttötiedot.
Jos alkuperäinen vastaus on tarkistettava
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttächoices[].index | Tyyppiinteger |
Kenttächoices[].message.content | Tyyppistring|null |
Kenttächoices[].message.tool_calls | Tyyppitool_call[] |
Kenttächoices[].message.reasoning_content | Tyyppistring |
Kenttächoices[].message.reasoning_details | Tyyppiobject|array |
Kenttächoices[].finish_reason | Tyyppistring|null |
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 deepseek-v3.1-thinking
Menetelmäpolkujen aliakset
/chat/completions
Liittyvät kutsujan ID:t
FAQ · DeepSeek: DeepSeek V3.1
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/chat/completions·deepseek-v3.1-thinking:text→text- Mitä kenttiä pyyntö käyttää?
POST /v1/chat/completions·deepseek-v3.1-thinking:model,messages,stream- Mitä rajoja sovelletaan?
POST /v1/chat/completions·deepseek-v3.1-thinking:messages.min_items:1