단 하나의 API 호출로 첫 AI 메시지 보내기

대부분의 AI 튜토리얼은 설정 체크리스트부터 시작합니다. 모델 제공업체를 선택하고, 계정을 만들고, 메모리를 위한 벡터 데이터베이스를 연결해야 합니다. 대화 상태를 유지할 서버를 구축해야 하고, 이 모든 것을 하나로 연결해야 합니다. 그리고 마침내 메시지를 보냅니다.

Backboard는 이 모든 과정을 생략합니다. 단 하나의 API 호출만으로 첫 메시지를 보낼 수 있습니다. 스레드(thread), 어시스턴트(assistant), 메모리, 그리고 수천 개의 모델에 걸친 라우팅이 이미 그 단일 호출 뒤에서 작동하고 있습니다. 사용자가 스택을 조립할 필요가 없습니다. 그것 자체가 스택입니다.

전체 과정은 다음과 같습니다.

1단계: 키 받기

app.backboard.io에 가입하고, 설정(Settings) > API Keys로 이동하여 키를 복사합니다. 신규 계정은 30일 동안 $5의 무료 크레딧을 제공받으며, 신용카드가 필요하지 않습니다.

이것이 유일한 설정입니다. 키는 항상 서버 측에 보관하고, 프론트엔드나 모바일 코드에는 절대 넣지 마세요.

2단계: 메시지 보내기

원하는 언어를 선택하세요. 세 가지 경우 모두 동일한 호출을 사용합니다.

Python

pip install backboard-sdk

import asyncio
from backboard import BackboardClient

...

JavaScript (Node 18+)

설치가 필요 없습니다. fetch만 사용하면 됩니다.

const response = await fetch("https://app.backboard.io/api/threads/messages", {
  method: "POST",
  headers: {
...

cURL

curl -X POST "https://app.backboard.io/api/threads/messages" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
...

실행합니다. 응답을 받습니다. 이것이 사용자의 첫 AI 메시지입니다.

방금 무슨 일이 일어났나

사용자는 하나의 문자열만 보냈습니다. Backboard가 나머지를 처리했습니다:

• 스레드 생성. 응답의 thread_id는 실시간 대화입니다. 이 ID를 사용하여 다음 메시지를 보내면 모델이 이전에 나눈 내용을 기억합니다.
• 어시스턴트 생성. assistant_id는 재사용 가능한 프로필입니다. 메모리, 문서, 도구를 첨부해도 호출을 변경할 필요가 없습니다.
• 모델 선택. 제공업체 설정이 필요하지 않습니다. 기본값은 openai / gpt-4o로 설정되었습니다. 아래에 표시된 두 개의 인수를 사용하여 변경할 수 있습니다.

벡터 DB도, 상태 서버도, 제공업체 SDK도 없습니다. 단 하나의 호출만으로 충분합니다.

대화 계속하기

thread_id를 다시 전달하세요. 이제 모델이 문맥 (Context)을 갖게 됩니다.

follow_up = await client.send_message(
    "Make it shorter.",
    thread_id=response.thread_id,
...

이것이 추가 인프라 없이 구현되는 상태 유지 대화 (Stateful conversation)입니다.

두 개의 인자로 모델 교체하기

하나의 키로 수천 개의 모델을 사용할 수 있습니다. 메시지마다 제공업체 (Provider)와 모델을 변경하세요. 동일한 스레드 (Thread), 동일한 코드입니다.

response = await client.send_message(
    "Explain quantum computing simply.",
    llm_provider="anthropic",
...

다음 턴에 다른 모델을 사용하고 싶으신가요? 문자열 두 개만 바꾸면 됩니다. 특정 제공업체에 종속되지 않습니다.

메모리 활성화하기

memory="Auto"를 추가하면 어시스턴트가 단일 스레드 내뿐만 아니라 대화 전반에 걸쳐 사실을 기억합니다.

# Thread 1: 무언가를 알려주기
await client.send_message(
    "My name is Sarah and I prefer dark mode.",
...

인자 하나로 구현되는 지속성 메모리 (Persistent memory). 프로비저닝할 데이터베이스도 필요 없습니다.

핵심 요약

플랫폼이 풀스택 (Full-stack)이기 때문에 첫 번째 호출이 단 한 줄로 끝납니다. 메모리, 모델 라우팅 (Model routing), RAG, 그리고 상태 유지 스레드 (Stateful threads)가 단 하나의 키 뒤에 자리 잡고 있습니다. 서비스가 아닌 인자를 추가함으로써, 작동하는 AI 메시지로 시작하여 필요에 따라 기능을 활성화할 수 있습니다.

가입하고, 키를 발급받아 첫 메시지를 보내보세요: app.backboard.io

전체 문서: docs.backboard.io