Come usare l'API Jev con APIMaster

Confronto con il prezzo ufficiale: Il prezzo live di -e.042 per 1M di token di input corrisponde al prezzo pubblicato da TypeSafe (senza ricarico).

Risposta rapida

Puoi chiamare Jev tramite APIMaster già da oggi. Crea una chiave API APIMaster, invia una richiesta POST a https://apimaster.ai/v1/systemone, imposta model su jev-latest e fornisci uno state più una o più questions tipizzate. Jev restituisce decisioni strutturate e probabilità; non è un modello di chat e non restituisce un messaggio dell'assistente.

Disponibilità attuale su APIMaster, verificata il 21 settembre 2026:

• ID modello: jev-latest (la rotta attiva attualmente risolve a Jev 1.13)
• Endpoint: POST https://apimaster.ai/v1/systemone
• Prezzo: $0,042 per 1M token di input; l'output è $0
• Rotte in vendita: 1 rotta attiva
• Input: testo, oggetti JSON o array in state
• Output: risposte tipizzate Choice, Score o Noul con probabilità e confidenza

La scheda di Jev nel marketplace è la fonte di verità per prezzo e disponibilità in tempo reale. L'articolo di APIMaster sull'API Jev spiega il modello e i limiti in dettaglio; questa pagina si concentra sull'integrazione funzionante più breve.

Cosa fa Jev

Jev è un modello decisionale della famiglia System One di TypeSafe. È utile quando la tua applicazione deve classificare, ordinare, verificare o instradare qualcosa e la risposta deve rientrare in uno schema che definisci in anticipo.

Invece di chiedere testo libero, descrivi le decisioni in questions:

• Noul: un giudizio sì/no con una probabilità
• Choice: un'opzione selezionata da una lista, con le probabilità per le varie opzioni
• Score: una valutazione rispetto a livelli che definisci tu

Questo rende Jev adatto per gate di moderazione, classificazione delle intenzioni, azioni del browser, routing, estrazione e controlli degli agenti. Lascia aritmetica, date, conteggi e generazione di testo al codice dell'applicazione o a un modello generativo. Jev decide; un altro componente può scrivere la risposta.

Chiamare Jev tramite APIMaster

1. Crea una chiave APIMaster

Crea un account su APIMaster, aggiungi credito pay-as-you-go e crea una chiave in API Keys. Salva la chiave come variabile d'ambiente:

export APIMASTER_API_KEY="your_api_key"

2. Invia una prima richiesta

La rotta Jev di APIMaster mantiene la forma nativa della richiesta System One di Jev. Non inviare messages, prompt o un payload chat-completions di OpenAI.

curl -X POST "https://apimaster.ai/v1/systemone" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "A user says: I was charged twice for the same order.",
    "questions": {
      "intent": {
        "type": "choice",
        "criteria": {
          "billing_issue": "Charges, refunds, invoices, or payments.",
          "technical_issue": "Bugs, outages, or integration problems.",
          "general_question": "All other general support questions."
        },
        "instructions": "Choose the user's primary support intent."
      },
      "needs_human": {
        "type": "noul",
        "instructions": "Should a human support agent review this case?"
      }
    }
  }'

La risposta contiene una risposta per ogni domanda, inclusi il valore selezionato e i dati di probabilità. Usa una soglia nel tuo codice prima di intraprendere un'azione irreversibile. Ad esempio, indirizza verso un flusso automatico solo quando la confidenza di intent supera la soglia che il tuo team ha validato.

3. Usa la risposta in Python

import os
import requests

response = requests.post(
    "https://apimaster.ai/systemone",
    headers={
        "Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "jev-latest",
        "state": {"message": "The checkout page crashes after I upload a receipt."},
        "questions": {
            "category": {
                "type": "choice",
                "criteria": {
                    "bug": "A technical fault or product error.",
                    "billing": "A charge, refund, invoice, or payment issue.",
                    "account": "Account access, identity, or settings."
                },
                "instructions": "Classify the support request.",
            },
            "urgent": {
                "type": "noul",
                "instructions": "Does the request require urgent handling?",
            },
        },
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()
print(result)

La stessa chiave APIMaster può essere usata per Jev e per i modelli generativi che la tua applicazione chiama dopo la decisione. Questo è utile per un flusso in due passaggi: lascia che Jev classifichi o instradi prima, poi invia solo i casi selezionati a un modello testuale.

Un pattern di routing pratico

Jev è più utile come livello di controllo attorno a un modello generativo. Un flusso di richiesta tipico è:

1. Inserisci l'input rilevante dell'utente o i campi del documento in state.
2. Poni diverse piccole domande in un'unica richiesta invece di fare una richiesta per domanda.
3. Controlla le probabilità restituite nel codice dell'applicazione.
4. Scegli una coda, uno strumento, un modello o un fallback in base alle tue soglie.
5. Chiama un modello generativo solo quando la tua applicazione ha bisogno di testo, codice o una risposta lunga.

Ad esempio, un'applicazione di supporto può usare Jev per identificare intento, urgenza e necessità di una ricerca dell'account in un'unica chiamata. Può poi instradare il ticket a un operatore umano, recuperare i dati corretti dell'account o chiamare un modello testuale per redigere la risposta.

Questa divisione è diversa dal chiedere a un LLM di restituire JSON sperando che rispetti lo schema. I tipi di output di Jev fanno parte del contratto della richiesta. Significa anche che non dovresti usare Jev per attività che richiedono di scrivere la risposta finale.

Jev rispetto a un modello di chat

Esigenza	Usa Jev	Usa un modello generativo
Scegliere un'etichetta da un insieme noto	Sì	Di solito non necessario
Stimare se una condizione è vera	Sì	Possibile, ma più difficile da vincolare
Instradare una richiesta a uno strumento o a un modello	Sì	Possibile, ma più costoso
Riassumere un documento	No	Sì
Scrivere una risposta rivolta all'utente	No	Sì
Eseguire aritmetica o conteggi esatti	Tienilo nel codice	Tienilo nel codice

Per l'architettura del modello, i limiti e i casi d'uso pubblicati, vedi Jev API: cos'è e quando usarla. Per un confronto diretto con il giudizio basato su LLM, vedi Jev vs LLM.

Errori di integrazione comuni

Inviare un payload di chat. https://apimaster.ai/v1/systemone si aspetta state e questions, non messages e temperature.

Aspettarsi output testuale. Jev restituisce decisioni tipizzate. Usa un modello generativo per la spiegazione o la risposta finale.

Fare una richiesta per ogni domanda. Metti le domande correlate nella stessa richiesta, così il modello può valutarle rispetto a uno stato condiviso.

Trattare la confidenza come una garanzia. Una probabilità è un segnale per routing e revisione. Valida le soglie sui tuoi esempi prima di usarle per decisioni in produzione.

Puntare Claude Code o Codex direttamente su Jev. Quegli strumenti si aspettano un comportamento del modello compatibile con Anthropic Messages o OpenAI Responses. Jev è posizionato meglio in una skill, un hook, uno strumento MCP o un router. Vedi Come usare Jev con Claude Code e Codex per i pattern funzionanti.

FAQ

Jev è disponibile tramite APIMaster?

Sì. Usa jev-latest con POST https://apimaster.ai/v1/systemone. La scheda del marketplace in tempo reale mostra attualmente una rotta attiva a $0,042 per 1M token di input, senza costo di output.

L'endpoint Jev è compatibile con OpenAI?

No. APIMaster espone il contratto nativo System One di Jev per questo modello. Usa state e questions tipizzate; non usare /chat/completions.

Jev può generare un riassunto o una risposta?

No. Jev restituisce decisioni tipizzate e probabilità. Passa il risultato a un modello generativo quando la tua applicazione ha bisogno di testo.

Posso usare la stessa chiave APIMaster per altri modelli?

Sì. Una chiave APIMaster può chiamare Jev e gli altri modelli abilitati per il tuo account. Controlla ogni scheda del marketplace per l'ID modello, la rotta e il prezzo attuali.

Da dove dovrei iniziare?

Inizia con la richiesta qui sopra, raccogli esempi rappresentativi e valida le tue soglie prima di aggiungere Jev a un'azione automatica. Poi leggi la guida completa all'API Jev e la guida all'integrazione con Claude Code/Codex.

Crea un account APIMaster, aggiungi credito, crea una chiave in API Keys e chiama jev-latest tramite https://apimaster.ai/v1/systemone.