Documentazione

API YurekAI

YurekAI è l'AI sovrana europea del gruppo ART (Lugano, Svizzera): modelli VITRUVIO, MERCURIO, QUARK e BERNOULLI serviti da infrastruttura europea con zero retention, conformità GDPR/nLPD e listini almeno il 30% sotto le grandi piattaforme americane. L'endpoint API è https://api.yurek.ai/v1, compatibile con gli SDK standard di mercato.

Endpoint REST nello standard di mercato: gli SDK e i tool che già usi funzionano cambiando solo URL e chiave. Le chiavi si creano dalla console (dashboard → API) e usano i limiti del tuo abbonamento. Zero retention: le conversazioni non addestrano i modelli né restano oltre il servizio.

Endpoint

https://api.yurek.ai/v1

Quickstart

curl https://api.yurek.ai/v1/chat/completions \
  -H "Authorization: Bearer $YUREKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "yurekai-mercurio-vf8",
       "messages": [{"role": "user", "content": "Ciao!"}],
       "stream": true}'

Compatibile con gli SDK OpenAI-style: imposta base_url su https://api.yurek.ai/v1 e api_key con la tua chiave.

Modelli

ID	Modello	Vocazione
`yurekai-vitruvio-vphi`	VITRUVIO vPhi v1.618	Il flagship: ragionamento frontier
`yurekai-vitruvio-mini-vphi`	VITRUVIO mini vPhi-Light	Il fratello agile
`yurekai-mercurio-vf8`	MERCURIO vF-8	Coding e agenti (default)
`yurekai-mercurio-mini-vf5`	MERCURIO mini vF-5	Conversazionale rapido
`yurekai-quark-vh`	QUARK v-h	Leggero, privacy-first, anche on-device
`yurekai-bernoulli-ve`	BERNOULLI v-e	Multilingue svizzero, terminologia giuridica e amministrativa

La lista live del tuo piano: GET https://api.yurek.ai/v1/models.

Prezzi a consumo

Le chiamate API consumano la quota settimanale del tuo piano: 3 milioni di token con Bottega, 15 con Rinascimento, 60 con Leonardo. Oltre la quota si prosegue con i crediti, senza cambiare piano.

Pacchetto	Token	Prezzo	Per milione
Schizzo	1 milione	CHF 4.90	CHF 4.90
Affresco	5 milioni	CHF 19.90	CHF 3.98
Capolavoro	15 milioni	CHF 49.90	CHF 3.33

Un prezzo solo per ingresso e uscita, per tutti i modelli del tuo piano. IVA inclusa. Volumi oltre 100 milioni di token al mese: offerta dedicata.

CLI

curl -fsSL https://yurek.ai/install.sh | sh          # macOS e Linux
irm https://yurek.ai/install.ps1 | iex               # Windows (PowerShell)
yurekai login     # accesso col YurekAI ID: consenti su yurek.ai il codice mostrato
yurekai -p "il tuo primo task"
yurekai update    # porta la CLI all'ultima versione

Accesso: yurekai login mostra un indirizzo e un codice; consenti col tuo YurekAI ID e la CLI riceve da sola la sua chiave sul tuo piano. Chi preferisce incollare una chiave creata dalla console usa yurekai login --chiave. La CLI parla di base con https://concierge.yurek.ai/api (configurabile con YUREKAI_API_URL); l'API REST per i tuoi programmi resta https://api.yurek.ai/v1.

Agente di coding con conversazione persistente, diff-preview, /undo, sessioni per cartella (--continue riprende l'ultima, --resume [id] sceglie) con compattazione automatica della conversazione lunga, server MCP (yurekai mcp add), skill personalizzate (~/.yurekai/skills/<nome>/SKILL.md, poi /<nome> nella REPL), hooks pre/post strumento, allowlist di auto-approvazione e lista deny che vince sempre, sotto-agenti per i sotto-compiti (strumento agent), connettori del tuo YurekAI ID (strumento connettore), immagini in ingresso (@schermata.png nel messaggio).

Per script e pipeline: yurekai -p "…" --output json restituisce un solo oggetto col risultato, --output stream-json un evento per riga. Senza terminale le azioni non consentite dall'allowlist si rifiutano invece di restare in attesa.

App

YurekAI per macOS (Apple Silicon) e Windows — Concierge, VULCANO e Atelier (controllo del computer con consenso) con QUARK locale e Privacy Gate. App iOS in beta. Il download è disponibile dalla console dopo l'accesso.

Account: accedi con Google o email/password; la chiave API viene creata automaticamente sul tuo piano e la cronologia si sincronizza su tutti i tuoi dispositivi (senza login, tutto resta solo sul device).
Dispatch: dall'app mobile invii un task e lo esegue il tuo Mac con l'app aperta e loggata sullo stesso account — consenso esplicito, cornice e cursore razzo mentre lavora, stop immediato.
Calcolo ibrido edge: i file grandi vengono indicizzati e cercati sul tuo dispositivo (RAG locale, zero upload del documento intero); al server arrivano solo i passaggi pertinenti — più veloce, più privato.
Memoria locale distillata: le tue correzioni restano sul device e QUARK le trasforma in dati sintetici anonimi; contribuiscono ai modelli solo col tuo consenso, via apprendimento federato.

Conformità

Conformità al GDPR europeo e alla nLPD svizzera, progettazione aderente all'EU AI Act. Infrastruttura sovrana YurekAI: nessun servizio AI di terze parti.