L'API di Ultineo AI
Esegui le applicazioni del catalogo dal tuo software. L'API comunica in JSON su HTTPS, autentica ogni chiamata con una chiave di progetto e risponde a ogni chiamata con lo stesso formato.
Costruita intorno a tre risorse
- Catalogo
Le applicazioni pubblicate, dalle più usate, ciascuna con i campi di input che richiede.
- Esecuzioni
Una chiamata avvia un'applicazione con i suoi input; un'altra rilegge l'esecuzione con la sua risposta.
- Chiavi
Chiavi di progetto con permessi, una scadenza facoltativa e uno stato che puoi disattivare.
Autenticazione e permessi
- Una chiave bearer
Invia la chiave del progetto nell'header Authorization di ogni chiamata, solo tramite HTTPS.
- Limitata a un solo progetto
Una chiave è legata a un solo progetto e non può mai leggere né scrivere i dati di un altro progetto, qualunque sia la richiesta.
- Conservata come hash
Viene conservato solo un hash della chiave, quindi la chiave viene mostrata per intero una sola volta. Una chiave persa si sostituisce, non si recupera mai.
Avvia un'esecuzione e leggi la sua risposta
- Creare
Indica l'applicazione e fornisci un valore per ogni campo di input, identificato dal nome del campo restituito dal catalogo.
- Seguire
Le esecuzioni sono asincrone: rileggi l'esecuzione finché il suo stato non è completata o non riuscita. Entrambi sono definitivi.
- Leggere
Un'esecuzione completata riporta la risposta, la durata e il numero di token in input e in output.
Un unico formato per ogni risposta
- Sempre gli stessi tre campi
Ogni risposta riporta il codice di stato, un breve titolo e il contenuto, sia in caso di successo sia di errore.
- Messaggi stabili
I messaggi di errore sono stringhe stabili in inglese che indicano il permesso mancante o il valore rifiutato.
- Limiti del piano espliciti
Una chiamata non coperta dal piano, o che supererebbe la sua quota, viene rifiutata con un codice di stato dedicato.
Ottenere una chiave
L'accesso all'API è incluso nei piani a pagamento di Ultineo AI. Non è ancora prevista la registrazione in autonomia: il nostro team apre il tuo progetto e ti consegna la sua prima chiave.
Collega il tuo software a Ultineo AI
Dicci cosa vuoi automatizzare e apriremo il tuo progetto e la sua chiave API.
Domande sull'API
I piani a pagamento. Il piano gratuito dà accesso alle applicazioni senza l'API.
No. Le istruzioni appartengono al proprietario dell'applicazione. L'API restituisce i campi di input, cioè ciò che compila chi effettua la chiamata.
La creazione di un'esecuzione risponde subito con il nuovo stato. Rileggi l'esecuzione finché non è completata per ottenere la risposta.
Sì. Ogni chiave ha dei permessi e una scadenza facoltativa, e una chiave non può mai creare un'altra chiave con permessi più ampi dei propri.