AI ToolBox API 사용법

Base URL

https://aitoolbox.kr/api/v1

공통 헤더

Authorization: Bearer aitb_live_...
Content-Type: application/json
X-AITB-Request-Id: 8f2b0b67-1c39-4a1d-aaf6-2c3b9b8f4e10

요청 Body

{
    "inputs": {
        "고객명": "홍길동",
        "요청내용": "사업계획서 초안에 들어갈 핵심 내용을 정리해 주세요."
    },
    "scope": {
        "space_codes": [
            "S25020623053746"
        ],
        "box_codes": [
            "B25060611223344"
        ]
    },
    "response_format": "json",
    "confirm_side_effects": false
}

cURL 실행

curl -X POST "https://aitoolbox.kr/api/v1/tools/{tool_id}/run" \
  -H "Authorization: Bearer aitb_live_..." \
  -H "Content-Type: application/json" \
  -H "X-AITB-Request-Id: 8f2b0b67-1c39-4a1d-aaf6-2c3b9b8f4e10" \
  -d '{
    "inputs": {
        "고객명": "홍길동",
        "요청내용": "사업계획서 초안에 들어갈 핵심 내용을 정리해 주세요."
    },
    "scope": {
        "space_codes": [
            "S25020623053746"
        ],
        "box_codes": [
            "B25060611223344"
        ]
    },
    "response_format": "json",
    "confirm_side_effects": false
}'

툴 디렉터리 검색

curl "https://aitoolbox.kr/api/v1/directory/tools?q=사업계획서&kind=workflow&limit=5" \
  -H "Authorization: Bearer aitb_live_..."

GPTs Action 스펙 조회

curl "https://aitoolbox.kr/api/v1/directory/tools/workflow.Wxxxxxxxxxxxx?include_spec=1" \
  -H "Authorization: Bearer aitb_live_..."

권장 MCP tool 구성

• aitb_search_spaces, aitb_search_boxes: 스페이스/박스 검색
• aitb_confirm_scope: 검색 후보를 실행 scope로 확정
• aitb_search_tools, aitb_toolchat: 툴 검색과 ToolChat 추천/자동채움
• aitb_run_tool: Prompt App 또는 Workflow 실행
• aitb_get_run: runs/{run_id}로 실행 결과 조회
• aitb_create_box, aitb_create_app, aitb_plan_workflow, aitb_create_workflow: 생성 기능

설계 원칙

• ChatGPT 연결은 API key가 아니라 OAuth access token으로 인증합니다.
• REST API 자동화는 기존 API key와 resource scope를 사용합니다.
• 쓰기/실행 tool은 서버 권한 검사와 ChatGPT 사용자 확인을 모두 전제로 합니다.
• 외부 쓰기 작업이 가능한 Workflow는 사용자 확인을 받은 뒤 confirm_side_effects를 true로 보냅니다.

키 관리

• 서비스별로 API 키를 분리하고 이름을 명확히 정합니다.
• 월 크레딧 한도와 만료일을 설정해 과도한 사용을 제한합니다.
• 키가 노출되면 즉시 폐기하고 새 키를 발급합니다.

요청 관리

• 민감한 고객 정보는 익명화하거나 요약해 inputs에 넣습니다.
• POST 요청마다 새 X-AITB-Request-Id를 보냅니다.
• AI 결과물은 초안으로 사용하고 중요한 수치와 사실은 원천 자료로 확인합니다.