Source: https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/ Canonical: https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/ Language: fi # Qwen2.5-VL-3b [Markdown](https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/index.md) · [JSON](https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/facts.json) ## [Qwen2.5-VL-3b](https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/) Qwen2.5-VL-3B-Instruct on Qwenin kompakti ohjeviritetty näkö- ja kielimalli tekstille, kuville ja videolle. Se palauttaa tekstiä ja rakenteista visuaalista tietoa, kuten dokumenttikenttiä, objektikoordinaatteja ja tapahtumakuvauksia, käyttäen dynaamista resoluutiota ja ajan huomioivaa videokäsittelyä. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/#method-0) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/qwen2-5-vl-3b-instruct/#method-1) Tietoa mallista Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle. Johdanto: ohjeviritetty 3B-versio Qwen2.5-VL-3B-Instruct on Qwen2.5-VL:n 3B-jäsen. Se vastaanottaa tekstiohjeita kuvien tai videon kanssa ja tuottaa tekstivastauksia, myös rakenteista dataa. Valitse se selkeästi määriteltyyn visuaaliseen kysymykseen, dokumenttien poimintatehtävään tai selitykseen, joka yhdistää näkyvän sisällön käyttäjän pyyntöön. Tämä täsmällinen koko ja julkaisu säilyttävät oman identiteettinsä; erityisesti muihin kokoluokkiin tai myöhempiin Qwen-sukupolviin lisättyjen ominaisuuksien ei tule olettaa soveltuvan tähän tarkistuspisteeseen. Visuaalinen ymmärtäminen ja agenttityönkulut Qwen kuvaa tavallisten objektien tunnistuksen sekä kirjoituksen, kuvaajien, kuvakkeiden, grafiikan ja sivuasettelujen analyysin. Määrittele lomakkeesta vaaditut kentät ja tyhjän arvon merkitys. Pyydä kuvaajasta johtopäätöstä tukevat akselit, yksiköt ja näkyvät arvot. Rajattu pyyntö helpottaa tulosteen vertaamista alkuperäiseen kuvaan verrattuna laajaan pyyntöön kuvailla kaikkea. Perhe tukee myös visuaalisten agenttien päättelyä ja työkalujen ohjausta tietokone- tai puhelintyönkuluissa. Malli voi tulkita käyttöliittymää ja auttaa toiminnon valinnassa; kytketyt sovellustyökalut suorittavat toiminnon. Kuvakaappausarvioinnissa voi kysyä, mikä ohjain vastaa tehtävää ja mikä näkyvä tieto tukee valintaa. Visuaalisen päättelyn käyttö ei itsessään anna laitteen hallintaa. Pitkä video ja tapahtumien paikannus Valmistaja kuvaa yli tunnin mittaisten videoiden ymmärtämisen ja pyydettyyn tapahtumaan liittyvien jaksojen tunnistamisen. Tämä on perheen kyky, ei ehdoton median latausraja tai tae jokaisen ruudun säilymisestä. Valmistele olennainen leike, säilytä sen ajoitustiedot ja kysy täsmällinen kysymys tapahtumasta, tapahtumaketjusta tai muutoksesta. Mallin videokäsittely käyttää ruututaajuustietoa visuaalisten havaintojen kohdistamiseen absoluuttiseen aikaan. Paikannus ja rakenteiset dokumentit Qwen2.5-VL voi palauttaa objektien sijainteja rajauslaatikoina tai pisteinä sekä koordinaatit ja ominaisuudet JSON-muodossa. Nimeä paikannustehtävässä kohdeobjekti ja määrittele, pitääkö tuloksen olla piste vai laatikko. Pidä koordinaattikäytäntö selkeänä tulosta käyttävässä sovelluksessa sen sijaan, että päättelisit mielivaltaisesta valokuvasta fyysisen mittauksen. Valmistaja dokumentoi myös rakenteisen poiminnan skannatuista laskuista, lomakkeista ja taulukoista. Anna luettava sivu ja tulosskeema: esimerkiksi kenttänimi, poimittu teksti ja sitä tukeva näkyvä alue. Säilytä lähteen yksiköt, desimaalierottimet ja taulukko-otsikot. Käsittele epävarma tai lukukelvoton sisältö tarkastustapauksena sen sijaan, että pyytäisit mallia keksimään puuttuvan arvon. Nämä valmisteluesimerkit soveltavat dokumentoituja kykyjä; ne eivät takaa täsmällistä poimintaa. Arkkitehtuurimuutokset Dynaaminen kuvaresoluutio laajennetaan videoon koulutuksella, jossa ruututaajuus vaihtelee. Päivitetty multimodaalinen sijaintikoodaus esittää ajallisen järjestyksen ja absoluuttisen ajan ja auttaa tunnistamaan tiettyjä hetkiä ja nopeuden muutoksia. Näköenkooderi käyttää ikkuna-attentiota yhdessä SwiGLU:n ja RMSNormin kanssa. Nämä muutokset kuvaavat mallin tapaa käsitellä visuaalista aineistoa; ne eivät osoita kiinteää viivettä tietylle sovellukselle. Kuvien ja videon valmistelu Viralliset esimerkit kattavat yksittäiset kuvat, useat kuvat, vain tekstiä sisältävät keskustelut, videotiedostot ja järjestetyt ruutuluettelot. Merkitse useat visuaaliset syötteet niin, että kysymys voi viitata kuhunkin. Pyydä kuvavertailuun merkintöjen mukaan järjestetty taulukko ja rajaa tulos näkyviin eroihin. Säilytä videoaikajanassa ruutujärjestys ja ajoitus sen sijaan, että esittäisit irrallisia kuvia ikään kuin niillä olisi tunnettu kesto. Kuvaprosessorin dokumentoitu oletusalue on neljästä 16,384 visuaaliseen tokeniin kuvaa kohti. Sen esimerkissä voidaan tavoitella 256–1,280 tokenia asettamalla pikselirajat. Se säilyttää kuvasuhteen näiden rajojen sisällä, kun taas nimenomaiset muutetut mitat kohdistetaan luvun 28 monikerroiksi. Suurempi yksityiskohtaisuus kuluttaa enemmän laskentaa ja sekvenssitilaa, joten pieni tekstikenttä voi tarvita korkeamman resoluution rajatun kuvan, kun taas yleinen näkymäyhteenveto ei välttämättä tarvitse. Nämä ovat valmistajan käsittelyohjaimia; sovelluksen latausvaihtoehdot voivat erota niistä. Konteksti ja sisällölliset rajat Julkaistun tarkistuspisteen konfiguraatio asettaa sijaintien enimmäismääräksi 128,000, kun taas mukana oleva pitkän tekstin osio käsittelee edelleen 32,768 tokenin aloituskonfiguraatiota. Opas kuvaa YaRN-ekstrapoloinnin mutta varoittaa, että se voi vaikuttaa merkittävästi ajalliseen ja spatiaaliseen paikannukseen, eikä suosittele menetelmää näihin tehtäviin. Se huomauttaa erikseen, että videon sijaintikoodaus voi sallia suuremman sijaintiasetuksen, ja antaa esimerkiksi 64K:n. Näitä erilaisia konfiguraatiokuvauksia ei tule sulauttaa yhdeksi yleisesti validoiduksi syötteen ylärajaksi. Teksti, visuaalinen aineisto ja vastaus jakavat rajallisen sekvenssibudjetin. Pidä olennainen sisältö luettavana, varaa tilaa tulokselle ja tarkista poimittu teksti, koordinaatit ja tapahtuma-ajat alkuperäistä vasten. Kortin 128 tokenin generointiesimerkki on havainnollistava eikä osoita erillistä ehdotonta tulosteen enimmäispituutta. Tämä malli palauttaa tekstianalyysiä tai rakenteista tietoa; sen näkö- ja kielikyvyt eivät tarkoita, että se tuottaisi kuvia tai videota. Käytännön tehtävä ### Käytännön tehtävä Tekninen esimerkki englanniksi ``` Organize a recorded event timeline Use only these text annotations from a clip: 00:02 worker picks up a box; 00:05 worker places the box on the scale; 00:08 scale display is obscured; 00:11 worker removes the box. Return the event sequence, the first annotated placement time and whether the weight is established. Preserve timestamps without claiming frame-level inspection. ``` #### Odotettu tulos ``` An ordered event table, a placement-time field and an unresolved weight field. ``` #### Tarkista tulos ``` Check that obscured weight remains unknown and the placement timestamp is attributed to the supplied annotation. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `qwen2.5-vl-3b-instruct` [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=chat) Alibaba /`qwen2.5-vl-3b-instruct` ### Aloitus Qwen2.5-VL-3B-Instruct on Qwenin kompakti ohjeviritetty näkö- ja kielimalli tekstille, kuville ja videolle. Se palauttaa tekstiä ja rakenteista visuaalista tietoa, kuten dokumenttikenttiä, objektikoordinaatteja ja tapahtumakuvauksia, käyttäen dynaamista resoluutiota ja ajan huomioivaa videokäsittelyä. 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` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat qwen2.5-vl-3b-instruct | Oletus— | | Kenttä`messages` | Tyyppi`message[]` | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— | | Kenttä`messages[].role` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Esimerkit: system, user, assistant, tool, function Ehdot: Nämä roolit esitetään nimenomaisesti lähdekoodin yhteensopivuustyypeissä; mallin täsmällinen roolijoukko pysyy mallikohtaisena. Riippuu mallista | Oletus— | | Kenttä`messages[].content` | Tyyppi`string\|content_part[]\|null` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`messages[].tool_calls` | Tyyppi`tool_call[]` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`messages[].tool_call_id` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: role=tool; käytä todella palautettua ID:tä | Oletus— | | Kenttä`messages[].name` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`messages[].reasoning_content` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Palauta todella saatu päättely takaisin mallille, kun kyseinen malli käyttää sitä | Oletus— | | Kenttä`messages[].reasoning_details` | Tyyppi`object\|array` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`max_tokens` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— | | Kenttä`max_completion_tokens` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— | | Kenttä`stream` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat | Oletusfalse | | Kenttä`stream_options.include_usage` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`temperature` | Tyyppi`number` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`top_p` | Tyyppi`number` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`stop` | Tyyppi`string\|string[]` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`tools` | Tyyppi`function_tool[]` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`tools[].type` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat function Riippuu mallista | Oletus— | | Kenttä`tools[].function.name` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: funktiotyökalu annettu | Oletus— | | Kenttä`tools[].function.description` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`tools[].function.parameters` | Tyyppi`JSON_schema` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`tool_choice` | Tyyppi`string\|object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`parallel_tool_calls` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`response_format` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`reasoning_effort` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`reasoning` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`service_tier` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`instructions` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Yhteensopivuuskenttä | Oletus— | | Kenttä`functions` | Tyyppi`function[]` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`function_call` | Tyyppi`string\|object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`prompt_cache_options` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`modalities` | Tyyppi`string[]` | VaatimusValinnainen | Arvot & rajat text | Oletus— | | Kenttä`provider` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options hylätään tällä Ultran tekstireitillä | Oletus— | | Kenttä`cache_control.ttl` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: 1h hylätään varsinaisissa kehotevälimuistin kohdissa | Oletus— | Syöteaineistojen yhdistelmät **Teksti** · UTF8-teksti `messages[].content` Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, messages | | Parametri`material_types` | Sopimustext | | Parametri`messages` | Sopimusviestitaulukko role/content-rakenteella | | Parametri`file_material` | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä | | Parametri`optional_controls` | Sopimusstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parametri`control_scope` | Sopimusmallikohtainen; käyttäjän funktiotyökalut eroavat palvelun isännöimistä työkaluista | | Parametri`output_modalities` | Sopimustext | | Parametri`hosted_operations` | Sopimusfalse | | Parametri`multimodal_input_binding` | Sopimusnull | 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.0004** / 1K tokenia Tuloste · Tulostokenit **$0.0012** / 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · OpenAI Chat curlPython SDKPython-suoratoisto ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "qwen2.5-vl-3b-instruct", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') 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 ``` ```python 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='qwen2.5-vl-3b-instruct',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) 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")) ``` ```python from openai import OpenAI import os from pathlib import Path 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) 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)) with client.chat.completions.stream(model='qwen2.5-vl-3b-instruct',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### 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** [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=chat) #### Menetelmäpolkujen aliakset Käytä yllä näytettyjä menetelmäpolkuja. #### Liittyvät kutsujan ID:t [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=chat) **Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `qwen2.5-vl-3b-instruct` [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=messages) Alibaba /`qwen2.5-vl-3b-instruct` ### Aloitus Qwen2.5-VL-3B-Instruct on Qwenin kompakti ohjeviritetty näkö- ja kielimalli tekstille, kuville ja videolle. Se palauttaa tekstiä ja rakenteista visuaalista tietoa, kuten dokumenttikenttiä, objektikoordinaatteja ja tapahtumakuvauksia, käyttäen dynaamista resoluutiota ja ajan huomioivaa videokäsittelyä. Hyväksytyt syötteet Teksti Tulokset json · sse ### Saatavilla Ailootissa · syötteet & menetelmät **Ailoot Ultra · Anthropic Messages** `POST /v1/messages` Syötetyypit `text` Tulostyypit `json`, `sse` Tulosteen muoto JSON tai SSE | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat qwen2.5-vl-3b-instruct | Oletus— | | Kenttä`messages` | Tyyppi`message[]` | VaatimusPakollinen | Arvot & rajat | Oletus— | | Kenttä`messages[].role` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— | | Kenttä`messages[].content` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat | Oletus— | | Kenttä`max_tokens` | Tyyppi`integer` | VaatimusPakollinen | Arvot & rajat | Oletus— | | Kenttä`stream` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat | Oletusfalse | Syöteaineistojen yhdistelmät **Teksti** · UTF-8-teksti `messages[].content-merkkijono` Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, messages, max\_tokens | | Parametri`optional_controls` | Sopimusstream | | Parametri`material_types` | Sopimustext | | Parametri`text_file_material` | SopimusLue varsinainen UTF-8-asiakirja ja sijoita sen teksti ilmoitettuun syöte- tai viestisisällön merkkijonoon. | Elinkaari: `synchronous_or_streamed` ### 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.0004** / 1K tokenia Tuloste · Tulostokenit **$0.0012** / 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · Anthropic Messages Täydellinen minimaalinen JSON-runkocurl · käytä omaa UTF-8-dokumenttiasiPython · tallenna koko tulos ```json { "model": "qwen2.5-vl-3b-instruct", "max_tokens": 128, "messages": [ { "role": "user", "content": "Summarize the incident report." } ], "stream": false } ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}" export AILOOT_TEXT_FILE python3 - <<'PY_REQUEST' import json, os from pathlib import Path source_file = Path(os.environ['AILOOT_TEXT_FILE']) if not source_file.is_file(): raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document') text = source_file.read_text(encoding='utf-8') if not text.strip(): raise SystemExit('Choose a document containing text') payload = {'model': 'qwen2.5-vl-3b-instruct', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]} payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8') PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \ -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -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 result = json.loads(Path('result.json').read_text(encoding='utf-8')) print(json.dumps(result, ensure_ascii=False, indent=2)) PY_RESULT ``` ```python import json, os from pathlib import Path source_file = Path(os.environ['AILOOT_TEXT_FILE']) if not source_file.is_file(): raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document') text = source_file.read_text(encoding='utf-8') if not text.strip(): raise SystemExit('Choose a document containing text') payload = {'model': 'qwen2.5-vl-3b-instruct', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]} payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text from urllib.request import Request, urlopen from urllib.error import HTTPError api_key = os.environ['AILOOT_API_KEY'] if not api_key.strip(): raise SystemExit('Set AILOOT_API_KEY before making a request') headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'} headers['x-api-key'] = api_key request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST') try: with urlopen(request, timeout=120) as response: raw = response.read() Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8') except HTTPError as error: Path('result.json').write_bytes(error.read()) Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8') raise Path('result.json').write_bytes(raw) import json from pathlib import Path result = json.loads(Path('result.json').read_text(encoding='utf-8')) print(json.dumps(result, ensure_ascii=False, indent=2)) ``` ### Vastaanota ja tallenna tulokset #### Ailoot Ultra · Anthropic Messages JSON tai SSE ##### Säilytä kaikki valmistuneet tulokset Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa. Säilytä kaikki sisältölohkot, päättelyallekirjoitukset ja todelliset työkalukäytön ID:t. Kokoa kaikki SSE-lohkomuutokset; ensimmäinen tekstilohko ei ole koko tulos. ##### 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ä`id` | Tyyppistring | | Kenttä`model` | Tyyppistring | | Kenttä`content[]` | Tyyppitext\|thinking\|tool\_use\|other content block | | Kenttä`stop_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** [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=messages) #### Menetelmäpolkujen aliakset Käytä yllä näytettyjä menetelmäpolkuja. #### Liittyvät kutsujan ID:t [`qwen2.5-vl-3b-instruct`](https://ailoot.ai/models/fi/#m=qwen2.5-vl-3b-instruct&route=Ultra&caller=qwen2.5-vl-3b-instruct&fmt=messages) FAQ · Qwen2.5-VL-3b Mitä syötteitä ja tuloksia on saatavilla? `POST /v1/chat/completions` · `qwen2.5-vl-3b-instruct`: `text` → `text` `POST /v1/messages` · `qwen2.5-vl-3b-instruct`: `text` → `json`, `sse` Mitä kenttiä pyyntö käyttää? `POST /v1/chat/completions` · `qwen2.5-vl-3b-instruct`: `model`, `messages`, `stream`, `modalities`, `provider` `POST /v1/messages` · `qwen2.5-vl-3b-instruct`: `model`, `messages`, `max_tokens`, `stream` Mitä rajoja sovelletaan? `POST /v1/chat/completions` · `qwen2.5-vl-3b-instruct`: `messages.min_items`: `1` Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi. ## Yritys ja sen projektisalkku Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. ## Osta tokenit alennuksella. Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista. Tilaus Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten. Kampanjakoodi jopa 50% Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan. Kulut historiassa Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle. [Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/) ## Yhdistä API tuotteeseen, jonka myyt. SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi. Kaupallinen sovellus Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin. Jälleenmyyjälisenssi Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot. Asiakirjat verkkosivustolla Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä. [Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi) ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.