API 레퍼런스

에토스AI의 채팅 백엔드 API입니다. 서버에서 프로바이더로 라우팅하고 텍스트를 스트리밍합니다.

POST /api/chat

대화 메시지 배열과 모델 ID를 받아, 선택된 모델의 응답을 스트리밍(plain text)으로 반환합니다.

Request Body (application/json)

Response

Content-Type: text/plain; charset=utf-8 의 스트림. 토큰이 생성되는 대로 이어붙여 렌더링합니다. 오류는 본문에 **[오류]** ... 형태로 포함됩니다. 스트림 끝에는 구분자(0x1F) 뒤에 사용량 메타 JSON({ model, input, output, conversationId?, ragSources? })이 붙습니다 — 화면 표시는 구분자 앞까지만 사용하세요.

예시 · cURL

curl -N -X POST http://localhost:3000/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "messages": [{ "role": "user", "content": "안녕하세요" }]
  }'

예시 · fetch (스트리밍)

const res = await fetch("/api/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    model: "gpt-4.1",
    messages: [{ role: "user", content: "요약해줘" }],
  }),
});
const reader = res.body!.getReader();
const dec = new TextDecoder();
let text = "";
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  text += dec.decode(value, { stream: true });
  // text 를 화면에 업데이트
}

상태 코드

그 외 앱 API 한눈에

모두 세션 쿠키 인증(로그인 필요). 워크스페이스/본인 소유 범위로 격리됩니다.