Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI
  1. API REST
  2. Agent

Completamenti chat di Nebula Agent

POST /chat/completions
CreateChatCompletion

Un completamento di Nebula Agent compatibile con OpenAI e stateless: invia ogni volta l'intera conversazione. Gli SDK OpenAI funzionano senza modifiche e model viene ignorato. Addebitato in base all'utilizzo con un minimo di 10 crediti; usage.credits_used riporta l'addebito. stream: true trasmette eventi server-sent. Non disponibile tramite MCP.

Il pagamento tramite wallet non è disponibile per questa operazione; usa l'autenticazione dell'account. guida al pagamento x402.

Parametri

Nessun parametro per questo endpoint.

Esempio cURL

curl --request POST \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/chat/completions' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "messages": [
    {
      "content": "What changed in NVIDIA sentiment this week?",
      "role": "user"
    }
  ],
  "stream": false,
  "thinking_mode": "auto"
}'

Risposte

200 OK
400 Richiesta non valida
401 Non autorizzato
402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati
403 Vietato
404 Non trovato
405 Metodo non consentito; l'header Allow elenca il metodo supportato
429 Troppe richieste
500 Errore interno del server
503 Servizio non disponibile

Tipo di media application/json

choices
array<object> obbligatorio

Scelte di completamento generate.
choices[].delta
object opzionale

Frammento di messaggio in streaming.
choices[].delta.content
string opzionale

Testo parziale della risposta dell'assistente in questo frammento dello stream.

choices[].delta.role
string opzionale

Ruolo nella conversazione quando emesso in questo frammento dello stream.

choices[].finish_reason
string opzionale

Motivo dell'interruzione della generazione, quando disponibile.

choices[].index
integer obbligatorio

Indice a base zero della scelta di completamento generata.

choices[].message
object opzionale

Messaggio dell'assistente completato per una risposta non in streaming.
choices[].message.content
string obbligatorio

Testo completo della risposta dell'assistente.

choices[].message.role
string obbligatorio

Ruolo nella conversazione del messaggio completato.

created
integer (int64) obbligatorio

Timestamp Unix di creazione del completamento.

id
string obbligatorio

Identificatore univoco assegnato al completamento della chat.

model
string obbligatorio

Identificatore del modello dell'agente Nebula.

object
string obbligatorio

Tipo di oggetto compatibile con OpenAI.

usage
object opzionale

Crediti consumati da questo completamento.
usage.credits_used
integer (int64) obbligatorio

Crediti Nebula consumati dalla richiesta.

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "NVIDIA sentiment strengthened this week as data-centre demand dominated discussion.",
        "role": "assistant"
      }
    }
  ],
  "created": 1786114800,
  "id": "chatcmpl_nebula_01",
  "model": "nebula-agent",
  "object": "chat.completion",
  "usage": {
    "credits_used": 10
  }
}