cicora.ai
API 사양CLI 및 앱

CLI 및 통합

키, 모델, 그리고 클라이언트 프로토콜에 맞는 기본 URL로 클라이언트를 구성하고 비밀 정보는 환경에 보관하세요.

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

호환 URL 선택

OpenAI 스타일 클라이언트에서는 CICORA_API_BASE_URL=https://cicora.ai/api/v1 로 설정하고 /v1을 두 번 추가하지 마세요.

Messages 클라이언트 또는 Claude Code에서는 다음과 같이 설정하세요. ANTHROPIC_BASE_URL=https://cicora.ai/api: 이 클라이언트는 /v1/messages를 직접 추가합니다. 추론 전에 모델 카탈로그를 통해 구성을 확인하세요.

호환 클라이언트 구성
bash
export CICORA_API_BASE_URL=https://cicora.ai/api/v1
export CICORA_API_KEY=replace_with_your_key

curl "$CICORA_API_BASE_URL/models" \
  --header "Authorization: Bearer $CICORA_API_KEY"

안전한 실행

  • 환경 변수는 비밀 관리자 또는 안전한 프로필을 통해 전달하세요.
  • 커밋에서 .env 파일과 내보낸 구성을 제외하세요.
  • 애플리케이션별로 키를 하나씩 발급하여 다른 애플리케이션을 중단하지 않고 접근 권한을 폐기할 수 있게 하세요.

이식 가능한 계약

보존 정책에서 허용하는 경우 Authorization이나 사용자 데이터 없이 요청 및 응답 로그를 유지하세요.

클라이언트가 자체 경로를 조합하는 경우 첫 생성 전에 디버그 로그에서 최종 URL을 비교하세요.