메시지 구성
요청에는 model, messages 및 max_tokens가 포함되고, 시스템 지침은 별도의 system 필드로 전송됩니다. 재시도 시 컨텍스트를 재현할 수 있도록 역할과 메시지 순서를 보존하세요.
원시 HTTP의 호출 주소는 https://cicora.ai/api/v1/messages, Messages SDK가 받는 주소는 게이트웨이 루트 https://cicora.ai/api 뿐이며, SDK가 /v1/messages를 직접 추가합니다.
Messages API 요청
bash
curl --request POST https://cicora.ai/api/v1/messages \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "anthropic/claude-sonnet-5",
"max_tokens": 500,
"system": "Answer with a compact checklist.",
"messages": [{"role": "user", "content": "Prepare a release plan."}]
}'도구 및 스트리밍
- 지원하는 모델에만 tools와 tool_choice를 추가하세요.
- 스트리밍 모드는 하나의 JSON 객체가 아니라 이벤트 시퀀스로 처리하세요.
- 작업을 수행하기 전에 도구 인수의 형식을 확인하세요.
형식 선택
한 요청에 두 형식의 필드를 섞지 마세요. 클라이언트 경계에서 chat 또는 messages를 선택하고 내부 기록은 한 번만 정규화하세요.
도구 결과와 긴 컨텍스트가 포함된, 저장된 비식별 대화로 마이그레이션을 테스트하세요.