cicora.ai
API 사양서버 전송 이벤트

스트리밍

완전한 응답을 기다리지 않고 SSE를 통해 토큰과 구조화된 델타를 받으세요.

통합 참조: 계정 API 설정과 환경용 모델 카탈로그에서 매개변수와 사용 가능한 기능을 선택하세요.

SSE 스트림 열기

stream: true를 활성화하고 클라이언트 버퍼링을 비활성화하세요. 응답의 일부를 사용할 수 있게 되면 서버가 데이터 이벤트를 전송합니다.

스트림을 점진적으로 처리하세요. 하나의 이벤트에 완성된 텍스트나 완전한 도구 호출이 들어 있을 필요는 없습니다.

SSE 스트림
bash
curl --no-buffer --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Write a three-line poem."}]
  }'

델타 조합

  • choice/index 또는 항목 식별자별로 텍스트를 누적하세요.
  • 도구 인수를 JSON 조각 스트림으로 모은 뒤 완료 후 파싱하세요.
  • 최종 지표가 중요하다면 스트림에서 사용 가능한 usage 옵션을 명시적으로 활성화하세요.

완료 및 취소

최종 이벤트가 도착한 뒤에만 스트림이 완료된 것으로 처리하세요. 최종 이벤트 없이 연결이 닫히면 별도의 실패 경로로 다루세요.

사용자가 화면을 이동할 때 사용하지 않는 요청이 열린 채로 남지 않도록 AbortController 또는 이에 상응하는 기능을 연결하세요.