Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI
  1. API REST
  2. Agente

Finalizaciones de chat del agente de Nebula

POST /chat/completions
CreateChatCompletion

Una completion de Nebula Agent sin estado y compatible con OpenAI: envía toda la conversación cada vez. Los SDK de OpenAI funcionan sin cambios y model se ignora. Se cobra por uso con un mínimo de 10 créditos; usage.credits_used informa del cargo. stream: true transmite eventos enviados por el servidor. No disponible a través de MCP.

El pago con cartera no está disponible para esta operación; usa la autenticación de cuenta. Guía de pago x402.

Parámetros

Este endpoint no tiene parámetros.

Ejemplo de 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"
}'

Respuestas

200 OK
400 Solicitud incorrecta
401 No autorizado
402 Créditos agotados; la respuesta incluye el momento de renovación y el saldo de créditos comprados
403 Prohibido
404 No encontrado
405 Método no permitido; el encabezado Allow enumera el método admitido
429 Demasiadas solicitudes
500 Error interno del servidor
503 Servicio no disponible

Tipo de medio application/json

choices
array<object> obligatorio

Opciones de finalización generadas.
choices[].delta
object opcional

Fragmento de mensaje en streaming.
choices[].delta.content
string opcional

Texto parcial de la respuesta del asistente en este fragmento del stream.

choices[].delta.role
string opcional

Rol de la conversación cuando se emite en este fragmento del stream.

choices[].finish_reason
string opcional

Motivo por el que se detuvo la generación, cuando está disponible.

choices[].index
integer obligatorio

Índice basado en cero de la opción de finalización generada.

choices[].message
object opcional

Mensaje del asistente completado para una respuesta sin streaming.
choices[].message.content
string obligatorio

Texto de la respuesta del asistente completada.

choices[].message.role
string obligatorio

Rol de la conversación del mensaje completado.

created
integer (int64) obligatorio

Marca de tiempo Unix de cuándo se creó la finalización.

id
string obligatorio

Identificador único asignado a la finalización del chat.

model
string obligatorio

Identificador del modelo del agente de Nebula.

object
string obligatorio

Tipo de objeto compatible con OpenAI.

usage
object opcional

Créditos consumidos por esta finalización.
usage.credits_used
integer (int64) obligatorio

Créditos de Nebula consumidos por la solicitud.

{
  "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
  }
}