1. 환경 준비
키는 환경 변수나 비밀 저장소에만 보관하세요. 브라우저 코드에 키를 넣거나 로그에 기록해서는 안 됩니다.
통합 기본 URL은 다음과 같습니다: https://cicora.ai/api/v1. 아래 각 예시는 이 기본 URL에 해당 경로를 추가합니다.
첫 요청
bash
export CICORA_API_KEY=replace_with_your_key
curl --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",
"messages": [{"role": "user", "content": "Explain this API in one sentence."}]
}'2. 요청 구성
- 카탈로그가 반환한 정확한 모델 식별자를 사용하세요.
- 메시지를 대화 순서대로 보내세요. system, user, assistant 순이며 필요한 경우 tool을 포함합니다.
- 낮은 변동성으로 시작한 뒤 작업에 맞게 매개변수를 조정하세요.
3. 응답 처리
사용 가능한 첫 번째 응답 항목에서 텍스트를 읽고 요청 ID를 자체 추적 ID와 함께 저장하세요.
재시도하기 전에 상태와 오류 구조를 확인하세요. 애플리케이션에서 중복 작업을 방지할 수 있는 작업만 재시도하세요.