채팅 전송 (OpenAI 호환)

OpenAI Compatible Chat Completions API는 OpenAI의 Chat Completions API와 호환되는 인터페이스를 제공합니다.
기존 OpenAI SDK나 라이브러리를 거의 수정 없이 사용할 수 있으며, Sionic AI의 고유한 기능(RAG 컨텍스트, 커스텀 변수, 노드 실행 추적 등)을 x_sionic 확장 필드를 통해 추가로 제공합니다.

Request

Authorization

Add parameter in header

storm-api-key

Example:

storm-api-key: ********************

Query Params

Header Params

Body Params application/jsonRequired

Examples

기본 요청 (스트리밍)대화 히스토리 유지파일 첨부 요청

{
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "회사의 휴가 정책에 대해 알려주세요."
        }
    ],
    "stream": true
}

Responses

🟢200Success

application/json

Body

Examples

비스트리밍 응답스트리밍 응답

{
    "id": "chat_xyz123abc456",
    "object": "chat.completion",
    "created": 1705312800,
    "model": "gpt-4",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "회사의 휴가 정책은 다음과 같습니다.\n\n1. 연차 휴가: 입사 1년 차에 15일이 부여되며, 매년 1일씩 추가됩니다.\n2. 병가: 연간 최대 30일까지 사용 가능합니다.\n3. 경조사 휴가: 본인 결혼 5일, 자녀 결혼 1일 등이 부여됩니다."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 50,
        "completion_tokens": 150,
        "total_tokens": 200
    },
    "x_sionic": {
        "thread_id": "thread_abc123def456",
        "agent_id": "agent_xyz789ghi012",
        "order_sheet_revision": 3,
        "contexts": [
            {
                "type": "document",
                "source_identifier": "dhash_abc123",
                "context": "연차 휴가는 입사 1년 차에 15일이 부여되며...",
                "page_name": "Page 5",
                "file_name": "휴가정책.pdf",
                "bucket_name": "HR 문서",
                "reference_idx": 1,
                "is_golden_chunk": true,
                "golden_chunk_rank": 1,
                "download_urls": {
                    "original": "https://s3.amazonaws.com/...",
                    "converted": "https://s3.amazonaws.com/..."
                }
            }
        ],
        "custom_variables": {
            "employee_name": "홍길동",
            "department": "개발팀"
        },
        "node_executions": [
            {
                "node_id": 1,
                "node_type": "request",
                "started_at": "2024-01-15T10:00:00.000Z",
                "ended_at": "2024-01-15T10:00:00.050Z",
                "status": "success",
                "duration_ms": 50
            },
            {
                "node_id": 2,
                "node_type": "rag",
                "started_at": "2024-01-15T10:00:00.050Z",
                "ended_at": "2024-01-15T10:00:01.200Z",
                "status": "success",
                "duration_ms": 1150
            },
            {
                "node_id": 3,
                "node_type": "llm",
                "started_at": "2024-01-15T10:00:01.200Z",
                "ended_at": "2024-01-15T10:00:05.800Z",
                "status": "success",
                "duration_ms": 4600
            }
        ]
    }
}

🟢200Success (Stream)

🟠400Request Validation Error

🟠401Unauthorized

🟠403Forbidden