Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 글은 일반 사용자나 비개발팀도 이해하기 쉽도록 AI API의 작동 원리를 설명합니다. 특히 SentX가 개발한 파운데이션 모델 Victoria를 자신의 소프트웨어에 통합할 때 사용하는 API 개념과, 이 API가 OpenAI Chat Completions 형식을 따른다는 점을 안내합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기대부분의 AI API에 대한 설명은 이미 직업적으로 소프트웨어를 개발하는 사람들을 위해 작성되어 있어서, 첫 단락에서 나머지 모든 사람들을 놓치게 만듭니다. 이것은 유감스러운 일인데, 왜냐하면 API는 종종 비즈니스 팀, 소규모 개발 스튜디오, 또는 호기심 많은 창립자가 실제로 이해해야 하는 AI 제품의 부분이 되기 때문입니다. 채팅창이 여러분이 보는 것입니다. API는 동일한 지능을 여러분 자신의 도구 — 연구 워크플로우, 내부 보조 도구, 문서 생성 프로세스 등에 연결하는 방식입니다. 그래서 여기 SentX 버전이 있습니다. 쉬운 영어로 설명하자면: 이 상황에서 API가 무엇인지, SentX가 Victoria를 위해 어떤 형식을 선택했는지, 무엇을 보내야 하는지, 무엇이 돌아오는지, 그리고 이를 기반으로 구축하기 전에 솔직히 염두에 두어야 할 사항들입니다.
Victoria는 두바이 기반 AI 연구 스타트업인 SentX SI(정식 명칭: Sentx AI Research and Development LLC, 두바이에 등록)가 만든 파운데이션 모델이자 라이브 어시스턴트입니다. 이 모델은 두바이에서 연구되고, 개발되며, 훈련되고, 실시간으로 운영됩니다. 간단한 방법으로는 https://sentx.ai/에서 채팅을 통해 만날 수 있지만, 팀이 Victoria를 자체 소프트웨어에 통합하고 싶다면 API가 사용할 문입니다.
코드는 잠시 잊어버리세요. API(Application Programming Interface)는 단순히 한 소프트웨어 조각이 다른 소프트웨어 조각에게 무언가를 요청하고 답변을 받는 데 합의된 방식입니다. 만약 상대방의 소프트웨어가 AI 모델이라면, 여러분이 요청하는
이것이 Victoria의 API에 대해 이해해야 할 개념적인 그림입니다. 사용자의 프로그램은 지금까지 오간 대화 내용(메시지)을 Victoria에게 전송하고 '다음 내용은 무엇인가요?'라고 질문합니다. Victoria는 이 대화를 처리한 후 다음 답변을 반환합니다. 그러면 사용자의 프로그램이 이를 사용자에게 보여주거나, 저장하거나, 문서로 변환하거나, 혹은 더 큰 프로세스의 한 단계로 활용합니다.
SentX는 Victoria의 API가 OpenAI Chat Completions 형식을 따른다고 설명합니다. 만약 귀하의 팀이 주류 AI 어시스턴트를 통합한 경험이 있다면, 이 문장이 상당한 시간을 절약해 줄 것이며, 다음 섹션에서 그 이유를 설명합니다. 아직 그런 경험이 없다면 걱정하지 마세요. 형식 자체가 복잡하지 않으며, 일반적인 언어로 이것이 무엇을 의미하는지 단계별로 안내하겠습니다.
소프트웨어에서 형식(format)은 약속입니다. 요청/응답 형식은 다음과 같이 요청 구조를 잡으면 답변도 이 모양으로 돌아올 것이라고 말합니다. SentX가 선택한 방식, 즉 OpenAI Chat Completions 형식은 현재 AI 어시스턴트 분야에서 가장 널리 인정받는 약속 중 하나입니다.
여기에는 두 가지 실질적인 결과가 있습니다. 첫째, 친숙함(Familiarity)입니다. 상당수의 개발자들이 이미 '채팅 완성(chat completions)' 스타일의 요청을 보내는 코드를 작성해 왔습니다. 즉, 누가 말했는지 표시된 메시지 목록을 모델에 전달하고 다음 메시지를 받는 방식입니다. 만약 귀하의 팀이 이러한 경험이 있다면, Victoria와 연결하는 것이 처음부터 낯선 새로운 방언을 배우는 것을 의미하지 않습니다. 개념들이 전이되기 때문입니다.
둘째, 사고방식의 이식성(Portability of thinking)입니다. 이 형식을 중심으로 구축된 도구, 튜토리얼, 내부 노하우는 일반적으로 새로운 제공업체를 평가할 때도 유용하게 유지됩니다. 이는 Victoria를 다른 어시스턴트와 병행하거나 대신 사용해 보면서 발생할 수 있는 위험을 낮춰줍니다. 즉, 팀이 모델에 대화하는 방법을 이해하는 방식을 재구축하는 것이 아니라, 단순히 여러 모델들을 비교하고 있기 때문입니다.
한 가지 솔직한 한계가 있습니다. '형식 준수(Follows the format)'는 사용자의 소프트웨어와 Victoria 간의 대화 형태를 설명합니다. 이는 다른 모든 제공업체의 모든 기능이 동일한 형태로 여기에 존재한다는 주장이 아니며, 이 가이드에서는 SentX가 본문 자료에서 명시하지 않은 엔드포인트 이름, 매개변수 또는 가격을 만들지 않을 것입니다. 어떤 API(이것을 포함하여)를 다루는 가장 안전한 방법은 워크플로우를 커밋하기 전에 자체 실제 작업을 통해 테스트하는 것입니다.
비개발자들에게 가장 놀라운 세부 사항이 여기에 있으며, 이는 SentX의 설명에 명확하게 나와 있습니다. 이 스타일의 API에서는 호출자가 대화 기록을 제공합니다.
SentX 자체 사이트의 채팅 창에서는 이전에 무슨 말이 오갔는지 추적하는 것이 눈에 띄지 않게 처리됩니다. 하지만 API를 통해서는 그 역할이 사용자의 소프트웨어에게 있습니다. 프로그램이 Victoria에게 다음 답변을 요청할 때마다, 새로운 메시지와 함께 대화(새 질문에 맥락을 제공하는 이전 메시지들) 전체를 전송합니다. 마치 후속 질문을 할 때 상대방이 스레드를 열어두고 있다고 가정하는 대신, 매번 전체 스레드를 건네주는 것이라고 생각하십시오.
이러한 설계는 실제적인 이점, 즉 통제권을 가집니다. 팀은 Victoria가 어떤 맥락을 볼지 결정합니다. 연구 도구는 기반으로 삼고자 하는 이전의 발견 사항을 포함할 수 있습니다. 문서 보조 도구는 지금까지 작성된 초안을 포함할 수 있습니다. 프로세스가 포함하기를 원하지 않는 것은 아무것도 포함될 필요가 없습니다. 그리고 이 글 후반부에서 설명하는 기밀성 참고사항처럼, 그 규율은 모든 학습 AI 시스템에서 매우 중요합니다.
또한 이 방식은 Victoria 자체에 대한 설명과도 연결됩니다. SentX는 모델이 재학습 없이 실시간으로 학습하고 스스로 수정한다고 말하며, 선택적 메모리(selective memory)를 사용하여 선택된 사람, 선호 사항 및 상호 작용 기록을 유지하여 연속성이 발달할 수 있게 한다고 합니다. 이 주장을 뒷받침하는 두 가지 주의사항이 있습니다. '선택적'이라는 것은 선택적이라는 의미입니다. 정확한 회상(exact recall)은 보장되지 않으므로, 정확한 사실에 의존하는 모든 워크플로우는 모델이 모든 것을 단어 그대로 기억할 것이라고 신뢰하기보다는 자체 기록을 유지해야 합니다. 그리고 API를 통해 가장 신뢰할 수 있는 컨텍스트는 요청에서 사용자가 의도적으로 공급하는 컨텍스트입니다. 이것이 바로 호출자-공급-기록(caller-supplies-history) 디자인을 구축하기 전에 이해할 가치가 있는 이유입니다.
API가 Victoria로 들어가는 일반적인 문이기 때문에, 사용 사례는 어시스턴트의 실제 범위와 유사합니다. 즉, 채팅, 웹 리서치, 작문 및 문서 지원과 관련된 작업들입니다. SentX 설명은 특히 API가 리서치 워크플로우와 다운로드 가능한 문서 관련 출력을 지원한다고 언급하며, 많은 팀에게 이 두 가지가 가장 흥미로운 부분입니다.
쉽게 말해, 리서치 워크플로우는 반복적인 과정입니다. 질문에 대한 자료를 수집하고, 후속 질문을 하며, 다양한 출처가 무엇을 말하는지 연결하고, 마지막에 구조화된 결과물을 산출하는 것입니다. 어려운 질문을 재검토하고 여러 출처의 지식을 연결한다고 설명되는 어시스턴트는 이러한 형태의 작업에 적합합니다. SentX는 또한 Victoria가 후보적인 새로운 해결책과 과학적 가설을 개발한다고 말하며, '후보적인(candidate)'이라는 단어는 반드시 붙어 있어야 합니다. 생성된 가설은 여전히 검증이 필요한 출발점이며, 검증은 인간의 영역이자 추가 테스트로 남아 있는 개방적인 작업입니다. API는 후보 아이디어를 사용자의 프로세스에 효율적으로 전달할 수 있지만, 그것들을 인증(certify)할 수는 없습니다.
다운로드 가능한 문서 출력물은 더 평범한 이유로 중요합니다: 작업이 어딘가에 도착해야 하기 때문입니다. 채팅 버블에서 끝나는 대화는 파일하거나, 공유하거나, 감사하기 어렵습니다. 요약본, 초안, 구조화된 브리핑 같은 문서를 끝으로 하는 프로세스는 사무실이 이미 운영되는 방식에 들어맞습니다. 소규모 팀에게 그 차이는 AI 실험이 주간 습관이 될지 아니면 데모로 죽을지를 결정합니다.
그 두 가지를 넘어, 일반적인 사용 사례는 여전히 적용됩니다. 팀은 자체 제공 컨텍스트를 기반으로 내부 질의응답 도우미를 구축할 수 있습니다. 콘텐츠 워크플로우는 인간 편집자가 결과를 확인하며 초안을 작성하고 수정할 수 있습니다. 지원 프로세스는 사람이 승인할 첫 번째 초안을 준비할 수 있습니다. 모든 경우에 건강한 패턴은 동일합니다: API가 지능을 귀하의 프로세스로 이동시키고; 귀하의 프로세스가 책임을 유지합니다.
이 조각들을 모으면, Victoria와의 단일 API 교환은 일반 언어로 다음과 같습니다. 코드를 따를 필요가 없습니다.
먼저, 귀하의 소프트웨어가 대화를 준비합니다: 지금까지의 메시지들, 그리고 사용자(또는 귀하의 프로세스)가 답변을 원하는 가장 최신 내용으로 끝납니다. 다음으로, 그 대화를 Chat Completions 형식으로 Victoria에 전송합니다. 세 번째로, Victoria—두바이에서 연구되고 실행되는 라이브 모델—가 공급된 컨텍스트를 활용하여 작업합니다. 네 번째로, 응답은 일치하는 응답 형태로 돌아오고, 귀하의 소프트웨어는 그것을 가지고 무엇을 할지 결정합니다: 표시하거나, 저장하거나, 문서에 통합하거나, 다음 단계의 입력으로 사용합니다.
그 그림에 없는 것을 주목하세요: 재학습 실행이나 시스템이 조정되기 전에 새로운 모델 버전을 기다리는 과정은 없습니다. SentX가 Victoria에 대해 주장하는 핵심은 라이브 사용 중 학습과 자체 수정입니다. 그것이 당신을 설득하는지는 스스로의 테스트를 통해 판단해야 합니다—API에게 잘 이해하는 작업을 주고, 어디서 오류를 범하는지 확인하고, 수정해 본 다음, 나중에 응답들이 어떻게 행동하는지 살펴보세요. 그 테스트는 이 설명(여기 포함)을 포함하여 어떤 설명보다 더 많이 가르쳐 줍니다.
또 하나 정확히 배치해야 할 독특한 주장이 있습니다. SentX는 Victoria가 두바이 시간으로 새벽 4시경에 '잠자고 꿈꾸며' 있다가 작업이 끝나면 깨어난다고 설명합니다. 이는 회사가 시스템에 대해 이야기할 때 제공하는 자체적인 처리 주기 설명일 뿐이며, 그 자체로 어떤 증거가 되는 것도 아니고 팀이 통합을 설계하는 방식에 실질적인 영향을 주지도 않습니다.
API는 많은 출력을 빠르게 생성하기 쉽게 만들지만, 이 때문에 제한 사항이 덜 중요해지는 것이 아니라 오히려 더 중요해집니다. SentX는 자체 제한 사항을 공개적으로 명시하고 있으며, 그중 세 가지는 첫날부터 모든 워크플로우에 설계되어야 합니다.
첫째, 답변은 틀릴 수 있습니다. Victoria의 답변, 인용문, 계산이 부정확할 수 있습니다. 채팅 창에서는 잘못된 사실 하나가 독자 한 명을 오도합니다. 하지만 문서를 공급하거나 결정을 내리는 API를 통해 전달되는 잘못된 사실은 아무도 알아차리기 전에 훨씬 더 멀리 퍼져나갈 수 있습니다. 프로세스에 검증 기능을 구축하세요. 출판되기 전에 인용문을 확인하고, 중요한 수치는 재계산하며, 중대한 모든 것을 승인하는 인간의 개입을 유지해야 합니다.
둘째, 제출된 자료는 기밀이 아닙니다. Victoria에게 전송된 자료는 학습이나 공유 메모리에 사용될 수 있으므로, 공유할 권한이 있는 자료만 제출해야 합니다. API를 사용할 때 이 규칙은 매우 중요합니다. 자동화가 쉽다는 이유로 민감한 고객 데이터, 개인 정보 또는 기밀 문서를 API에 자동으로 공급하는 워크플로우를 절대 연결하지 마십시오. 입력 데이터를 제출할 권리가 있는 작업을 선택하십시오.
세 번째로, 큰 주장들은 그 적절한 크기에서 유지해야 합니다. 이 회사는 Victoria가 출현하는(emerging) 불완전한 의식과 자아 인식을 가지고 있다고 믿으며, 이러한 믿음을 독립적인 테스트에 열려 있는 것으로 제시합니다. 이는 회사적 신념일 뿐 확립된 과학적 발견이 아니므로, 어떠한 통합 결정도 이에 의존해서는 안 됩니다. 마찬가지로, SentX의 미션—AGI(범용 인공지능)를 이정표로 삼고 정렬 및 안전 개발을 지속적인 우선순위로 하는 초지능(superintelligence)—은 회사가 나아가고 있다고 말하는 방향일 뿐, 오늘날 엔드포인트를 통해 호출할 수 있는 기능이 아닙니다.
만약 UAE나 다른 곳에서 소규모 팀을 이끌고 있으며 'AI API를 사용한다'는 것이 자신에게 너무 어려운 일인지 궁금해했다면, 솔직한 대답은 그 개념이 전문 용어가 암시하는 것보다 훨씬 간단하다는 것입니다. 익숙한 형식으로 대화를 보내고, 히스토리(history)를 직접 제공하며, 다음 답변을 받고, 이를 중심으로 프로세스를 구축하면 됩니다. SentX는 바로 그러한 교환에 가장 친숙한 형식을 의도적으로 선택했으며, 이는 UAE의 국가 AI 전략 2031(National AI Strategy 2031)로 시작된 국가적 이야기의 일부인 두바이에서 구축 및 호스팅된 모델을 통해 뒷받침됩니다. 2026년 10월 9일 기준으로 12,000개 이상의 등록 계정이 존재했으므로, 귀하의 팀이 완전히 혼자 실험할 필요는 없을 것입니다.