업데이트: 2026-06-23

Tool Calling

본 문서는 Crazyrouter 생산 환경에서 실제 요청으로 검증에 성공한 Tool Calling 사용법만 수록합니다. 검증 일시:

2026-03-22

검증 완료된 모델:

gpt-5.5
claude-opus-4-8
gemini-3.1-pro

검증 완료 기능 매트릭스

모델	프로토콜	엔드포인트	성공 표지
`gpt-5.5`	OpenAI Chat Completions	`POST /v1/chat/completions`	`tool_calls` 반환
`claude-opus-4-8`	Anthropic Messages	`POST /v1/messages`	`tool_use` 블록 반환
`gemini-3.1-pro`	Gemini Native	`POST /v1beta/models/{model}:generateContent`	`functionCall` 반환

Claude의 Tool Calling은 현재 Anthropic Messages 프로토콜 기준으로 검증되었습니다. 즉 POST /v1/messages가 tool_use 블록을 반환하는 방식입니다. 이 결론을 Claude의 OpenAI 호환 /v1/chat/completions 경로로 확대 적용하지 마세요. Copilot, Continue, 일부 VS Code Agent, 또는 Tool Calling에 의존하는 다른 코딩 시나리오에서는 OpenAI 호환 엔드포인트가 Claude 네이티브 Tool Calling을 정상적으로 끌어내지 못할 수 있습니다. Claude 코딩 Agent 기능이 필요할 때는 Claude Code 또는 Anthropic 네이티브 클라이언트 설정을 우선 사용하세요.

GPT-5.4

cURL

curl https://api.crazyrouter.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Use the get_time tool for Asia/Shanghai. Do not answer without calling the tool."
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_time",
          "description": "Get the current time for a timezone",
          "parameters": {
            "type": "object",
            "properties": {
              "timezone": {
                "type": "string"
              }
            },
            "required": ["timezone"],
            "additionalProperties": false
          }
        }
      }
    ],
    "tool_choice": "required"
  }'

생산 환경 검증에서 반환된 핵심 필드:

{
  "tool_calls": [
    {
      "type": "function",
      "function": {
        "name": "get_time",
        "arguments": "{\"timezone\":\"Asia/Shanghai\"}"
      }
    }
  ]
}

Claude Sonnet 4.6

cURL

curl https://api.crazyrouter.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 256,
    "tools": [
      {
        "name": "get_time",
        "description": "Get the current time for a timezone",
        "input_schema": {
          "type": "object",
          "properties": {
            "timezone": {
              "type": "string"
            }
          },
          "required": ["timezone"]
        }
      }
    ],
    "tool_choice": {
      "type": "any"
    },
    "messages": [
      {
        "role": "user",
        "content": "Use the get_time tool for Asia/Shanghai. Do not answer directly."
      }
    ]
  }'

생산 환경 검증에서 반환된 핵심 필드:

{
  "stop_reason": "tool_use",
  "content": [
    {
      "type": "tool_use",
      "name": "get_time",
      "input": {
        "timezone": "Asia/Shanghai"
      }
    }
  ]
}

첫 라운드 연동 시 권장 사항:

Claude 네이티브 /v1/messages의 경우, 우선 명시적으로 tool_choice를 추가하세요
프롬프트에서 “반드시 도구를 호출해야 하며, 직접 답하지 마세요”라고 명확히 요구하세요
이렇게 하면 tool_use를 더 안정적으로 재현할 수 있습니다

Gemini 3 Pro

cURL

curl "https://api.crazyrouter.com/v1beta/models/gemini-3.1-pro:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Use the get_time function for Asia/Shanghai."
          }
        ]
      }
    ],
    "tools": [
      {
        "functionDeclarations": [
          {
            "name": "get_time",
            "description": "Get the current time for a timezone",
            "parameters": {
              "type": "object",
              "properties": {
                "timezone": {
                  "type": "string"
                }
              },
              "required": ["timezone"]
            }
          }
        ]
      }
    ]
  }'

생산 환경 검증에서 반환된 핵심 필드:

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "functionCall": {
              "name": "get_time",
              "args": {
                "timezone": "Asia/Shanghai"
              }
            }
          }
        ]
      }
    }
  ]
}

어떤 상황에 어떤 프로토콜을 사용할지

프로젝트에서 이미 OpenAI SDK를 사용하고 있다면, gpt-5.5의 OpenAI 호환 방식을 우선 사용하세요
Claude 네이티브 연동을 하고 있다면, /v1/messages를 우선 사용하고, 첫 라운드 검증 시 tool_choice를 추가하세요
Gemini 네이티브 기능 연동을 하고 있다면, Gemini Native API를 우선 사용하세요

시작하기

핵심 기능

모델 공식 가격

Tool Calling

Tool Calling

검증 완료 기능 매트릭스

GPT-5.4

Claude Sonnet 4.6

Gemini 3 Pro

어떤 상황에 어떤 프로토콜을 사용할지

관련 문서

​Tool Calling

​검증 완료 기능 매트릭스

​GPT-5.4

​Claude Sonnet 4.6

​Gemini 3 Pro

​어떤 상황에 어떤 프로토콜을 사용할지

​관련 문서

Tool Calling

검증 완료 기능 매트릭스

GPT-5.4

Claude Sonnet 4.6

Gemini 3 Pro

어떤 상황에 어떤 프로토콜을 사용할지

관련 문서