ColdFusion은 AI API를 호출하는 데 매우 적합합니다. Claude (Anthropic)와 ChatGPT (OpenAI) 모두 일반적인 HTTP/REST + JSON 서비스이며, cfhttp, serializeJSON(), 그리고 deserializeJSON()은 CFML이 항상 보유해 온 바로 그 도구들이기 때문입니다. 기존의 레거시 앱을 다시 작성할 필요가 없습니다. AI 통합은 부가적인 요소로 추가됩니다. API 키를 헤더에 포함하여 제공자의 엔드포인트로 JSON 요청을 POST하고, JSON 응답을 파싱하여 결과를 사용하면 됩니다. Claude의 경우, x-api-key 헤더와 anthropic-version: 2023-06-01 헤더를 사용하여 https://api.anthropic.com/v1/messages로 POST를 보냅니다. ChatGPT의 경우, Authorization: Bearer 헤더와 함께 https://api.openai.com/v1/chat/completions로 POST를 보냅니다. 모든 사람을 당황하게 만드는 ColdFusion 특유의 주의사항(gotcha)이 하나 있습니다. LLM은 느리기 때문에 (토큰을 하나씩 생성함), cfhttp timeout을 높게 설정해야 하며, 페이지 requesttimeout은 그보다 더 높게 설정해야 합니다. 그렇지 않으면 모델이 응답하기 전에 ColdFusion이 스레드(thread)를 종료해 버립니다. 최신 ColdFusion (2025 릴리스)은 심지어 네이티브 ChatModel() 추상화를 제공하지만, cfhttp 방식은 레거시 설치 버전을 포함한 모든 CF 버전에서 작동합니다. 이 가이드는 두 제공자, 두 가지 구문, 그리고 중요한 운영 환경(production) 고려 사항을 모두 보여줍니다.
더 읽어보기