전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON
  1. REST API
  2. Agent

Nebula Agent 채팅 완성

POST /chat/completions
CreateChatCompletion

OpenAI 호환의 상태 비저장 Nebula Agent 완성입니다. 매번 전체 대화를 보내야 합니다. OpenAI SDK는 그대로 작동하며 model는 무시됩니다. 사용량에 따라 과금되고 최소 10크레딧이 부과되며, usage.credits_used가 청구 내역을 보고합니다. stream: true는 서버 전송 이벤트를 스트리밍합니다. 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 필수

생성된 완성 선택지의 0부터 시작하는 인덱스입니다.

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