Вся документация Документация Nebula Все эндпоинты Интерактивная документация Markdown OpenAPI JSON
  1. REST API
  2. Агент

Завершения чата Nebula Agent

POST /chat/completions
CreateChatCompletion

Совместимое с OpenAI, не сохраняющее состояние завершение Nebula Agent: отправляйте всю переписку каждый раз. SDK OpenAI работают без изменений, а model игнорируется. Оплата по факту использования с минимумом 10 кредитов; usage.credits_used сообщает о списании. stream: true передаёт события server-sent events. Недоступно через MCP.

Оплата кошельком недоступна для этой операции; используйте аутентификацию аккаунта. Руководство по оплате x402.

Параметры

У этого эндпоинта нет параметров.

Пример 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"
}'

Ответы

200 OK
400 Некорректный запрос
401 Не авторизован
402 Кредиты израсходованы; ответ содержит срок продления и баланс купленных кредитов
403 Доступ запрещён
404 Не найдено
405 Метод не поддерживается; поддерживаемые методы перечислены в заголовке Allow
429 Слишком много запросов
500 Внутренняя ошибка сервера
503 Сервис недоступен

Тип медиа application/json

choices
array<object> обязательный

Сгенерированные варианты ответа.
choices[].delta
object необязательный

Фрагмент потокового сообщения.
choices[].delta.content
string необязательный

Часть текста ответа ассистента в этом фрагменте потока.

choices[].delta.role
string необязательный

Роль в диалоге, передаваемая в этом фрагменте потока.

choices[].finish_reason
string необязательный

Причина остановки генерации, если доступна.

choices[].index
integer обязательный

Индекс сгенерированного варианта ответа, начиная с нуля.

choices[].message
object необязательный

Завершённое сообщение ассистента для ответа без потоковой передачи.
choices[].message.content
string обязательный

Завершённый текст ответа ассистента.

choices[].message.role
string обязательный

Роль в диалоге завершённого сообщения.

created
integer (int64) обязательный

Unix-временная метка создания завершения.

id
string обязательный

Уникальный идентификатор, присвоенный завершению чата.

model
string обязательный

Идентификатор модели агента Nebula.

object
string обязательный

Тип объекта, совместимый с OpenAI.

usage
object необязательный

Кредиты, израсходованные на это завершение.
usage.credits_used
integer (int64) обязательный

Кредиты Nebula, израсходованные на запрос.

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