Guida rapida alle API
Inizia con le API di Ninja e potenzia i tuoi prodotti di intelligenza artificiale con velocità, scalabilità e affidabilità senza pari.
Registrazione
Registrati all'indirizzo Super MyNinja.ai per iniziare a utilizzare le nostre API.
Puoi registrarti gratuitamente o abbonarti a un livello Ultra o Business. Ultra e Business ti danno accesso illimitato al parco giochi per sperimentare i nostri LLM di punta, che si occupano di ragionamento e ricerca approfondita*.
Quando sei pronto per passare dall'esplorazione all'esecuzione, acquista crediti per iniziare a creare prodotti ed esperienze di intelligenza artificiale per la codifica, la scrittura e molto altro.
* Soggetto a soglie di abuso
Crediti di acquisto
Dopo esserti iscritto a Super MyNinja.ai, vai al pannello di sinistra e fai clic su icona API.

Quindi vai a «Abbonamento e crediti».

Sotto «I tuoi crediti» clicca «Crediti di acquisto».

Nel «Importo del pagamento automatico» campo, inserisci l'importo che desideri acquistare in cambio di crediti (minimo $30).

Nel «Soglia di pagamento automatico» campo, imposta l'importo della soglia che quando il saldo scende al di sotto di tale importo ricaricheremo il «Importo del pagamento automatico». Questo ti assicura di non esaurire i crediti o che la tua chiave API smetta di funzionare (minimo $25).

Seleziona il tuo metodo di pagamento preferito e fai clic su «Conferma e paga». Verrai quindi reindirizzato a una schermata di fatturazione di Stripe per completare il pagamento.

Genera una chiave API
Dopo aver acquistato i tuoi crediti, vai alla «Gestisci le tue chiavi API» sezione sulla Pagina delle chiavi API e dei crediti.

Fai clic su «Crea una nuova chiave» pulsante.

Nel «Nome» campo, inserisci un nome per la tua chiave (ad es. Chiave di produzione) e quindi fare clic su «Crea chiave».

Una volta generata la chiave, copialo e salvalo in un posto sicuro, poiché chiunque abbia accesso può usarlo. Se necessario, puoi rigenerare una nuova chiave.

Utilizzo delle API Ninja
Vista d'insieme
URL di base:
https://api.myninja.ai/v1
Autenticazione:
Tutte le richieste richiedono una chiave API passata nell'intestazione come segue, <token-key>dov'è il token di autenticazione:
Autorizzazione: portatore <token-key>
Punto finale:
POSTA /chat/completamenti
Questo endpoint accetta richieste di chat e trasmette risposte in streaming in base al modello specificato.
Modelli:
I modelli attualmente disponibili includono:
ricerca approfondita sui ninja
ninja-super-agent: turbo
superagente ninja: apex
Ninja-super-agent: ragionamento
Questi modelli possono essere selezionati fornendo modello parametro nel corpo della richiesta.
Formato di richiesta
L'API Ninja segue il Specifiche API OpenAI da vicino. L'oggetto JSON della richiesta contiene:
modello (stringa):
L'identificatore del modello da utilizzare (ad es. «ricerca approfondita sui ninja»).
messaggi (array):
Una serie di oggetti messaggio. Ogni oggetto segue il formato:
stream (booleano):
Quando è impostato su vero, l'API risponde con una risposta in streaming.
stream_options (oggetto):
Opzioni aggiuntive per lo streaming, come «include_usage»: vero per includere i dettagli sull'utilizzo dei token.
extra_headers (oggetto):
Eventuali intestazioni aggiuntive richieste dall'API Ninja (nessuna a questo punto)
Esempio di richiesta (json)
Risposta
L'API restituisce un flusso di ChatCompletionChunk oggetti. Ogni blocco può contenere:
Contenuto:
Il testo del completamento, che può includere passaggi di ragionamento racchiusi in XML.
Citazioni:
Un elenco di URL che supportano il ragionamento fornito.
Informazioni sull'utilizzo:
Statistiche sull'utilizzo dei token se «include_usage»: vero è stato specificato.
Il codice cliente può elaborare questi blocchi per visualizzare una risposta completa che include:
Fasi di ragionamento: Estratto e formattato da segmenti XML.
Citazioni: Visualizzato come elenco numerato.
Statistiche di utilizzo: Mostra i token di input e output.
Esempi di codice di esempio
Prezzi
modalità
Prezzo di ingresso/ per M gettoni
Prezzo alla produzione/ per M gettoni
Prezzo/ compito
Qwen 3 Coder 480B (Cerebras)
—
—
1,50$
modalità standard
—
—
1,00 USD
Modalità complessa
—
—
1,50$
modalità veloce
—
—
1,50$
modalità
Prezzo di ingresso/ per M gettoni
Prezzo alla produzione/ per M gettoni
Prezzo/ compito
Qwen 3 Coder 480B (Cerebras)
3,75$
3,75$
—
modalità standard
1,50$
1,50$
—
Modalità complessa
4,50$
22,50$
—
modalità veloce
3,75$
3,75$
—
Modello
Prezzo di ingresso/ per M gettoni
Prezzo alla produzione/ per M gettoni
Turbo 1.0
0,11$
0,42$
Apex 1.0
0,88$
7,00$
Ragionamento 2.0
0,38$
1,53$
Ricerca approfondita 2.0
1,40$
5,60$
Limiti tariffari
Ninja AI impone limiti di frequenza alle richieste di inferenza per modello per garantire che gli sviluppatori siano in grado di provare l'inferenza più veloce.
Modello
Richiesta al minuto (GIRI/MIN)
Turbo 1.0
50
Apex 1.0
20
Ragionamento 2.0
30
Ricerca approfondita 2.0
5
Domande frequenti
Ecco cosa devi sapere sull'API di Ninja in base a ciò che ci viene chiesto di più.
Come posso aumentare la soglia e l'importo del pagamento automatico?
In Ninja, vai al pannello di sinistra e fai clic su icona di gestione delle API.
Sotto «I tuoi crediti» clicca «Gestisci crediti».
Nel «Importo del pagamento automatico» campo, inserisci l'importo che desideri aumentare per i crediti (minimo $30).
Nel «Soglia di pagamento automatico» campo, modifica l'importo della soglia che quando il saldo scende al di sotto di tale importo ricaricheremo il «Importo del pagamento automatico». Questo ti assicura di non esaurire i crediti o che la tua chiave API smetta di funzionare (minimo 25$).
Fare clic «Salva modifiche» per confermare.
Come posso annullare il mio contratto di pagamento automatico?
In Ninja, vai al pannello di sinistra e fai clic su icona di gestione delle API.
Seleziona «Chiavi e crediti API» poi vai a «I tuoi crediti» sezione.
Sotto «I tuoi crediti» clicca «Altre opzioni».
Seleziona «Annulla il pagamento automatico dei crediti»(minimo $30).
Fare clic «Elimina pagamento automatico» per confermare.
Come faccio a eliminare una chiave API?
In Ninja, vai al pannello di sinistra e fai clic su icona di gestione delle API.
Seleziona «Chiavi e crediti API» poi vai a «Chiavi API».
Trova la tua chiave API e seleziona l'icona del cestino a destra.
Fare clic «Elimina chiave API» per confermare.
Come posso visualizzare l'utilizzo di ogni richiesta API?
In Ninja, vai al pannello di sinistra e fai clic su icona di gestione delle API.
Quindi fai clic «Utilizzo dell'API».
Sul «Utilizzo dell'API» pagina, vedrai una tabella che mostra i seguenti dettagli per ciascuna API:
Nome chiave
Modello
Token di input e output
Costo di ingresso e uscita
Timestamp per richiesta
Costo totale