Claude - Messages API

##모든 API는 Bearer Token 인증이 필요합니다## **API Key 받기:** [API Key 관리 페이지](https://starmagic.ai/app/api-keys)를 방문하여 API Key를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

프롬프트를 완성할 모델.

"claude-haiku-4-5-20251001"

입력 메시지. 모델은 `user`와 `assistant`가 번갈아 나오는 대화 턴에서 작동하도록 훈련되었습니다. 새 `Message`를 생성할 때 `messages` 매개변수로 이전 대화 턴을 지정하면, 모델이 대화의 다음 `Message`를 생성합니다. 요청에서 연속된 `user` 또는 `assistant` 턴은 하나의 턴으로 결합됩니다. 각 입력 메시지는 `role`과 `content`가 포함된 객체여야 합니다. 단일 `user` 역할 메시지를 지정하거나 여러 `user` 및 `assistant` 메시지를 포함할 수 있습니다.

[
  {
    "content": null,
    "role": "user"
  }
]

중지하기 전에 생성할 최대 토큰 수. 모델이 이 최대값에 도달하기 _전에_ 중지할 수 있습니다. 이 매개변수는 생성할 토큰의 절대 최대 수만 지정합니다.

0

추론 처리를 수행할 지리적 리전을 지정합니다. 지정하지 않으면 워크스페이스의 `default_inference_geo`가 사용됩니다.

"string"

요청 간 재사용을 위한 컨테이너 식별자.

컨텍스트 관리 설정.

이 요청에 사용될 MCP 서버

[
  {
    "authorization_token": null,
    "name": "string",
    "tool_configuration": null,
    "type": "string",
    "url": "string"
  }
]

{
  "user_id": null
}

{
  "effort": "low",
  "format": {
    "schema": {},
    "type": "string"
  },
  "task_budget": {
    "remaining": 0,
    "total": 0,
    "type": "string"
  }
}

이 요청에 우선 용량 (사용 가능한 경우) 또는 표준 용량을 사용할지 결정합니다.

"auto"

모델이 생성을 중단하게 하는 사용자 정의 텍스트 시퀀스.

[
  "string"
]

서버 전송 이벤트를 사용하여 응답을 점진적으로 스트리밍할지 여부.

true

시스템 프롬프트.

응답에 주입되는 무작위성의 양입니다. 기본값은 `1.0`입니다. 범위는 `0.0`에서 `1.0`까지입니다.

0

Claude의 확장 사고를 활성화하기 위한 설정. `type: "enabled"`에서는 `budget_tokens`가 필요하며, 최소 1,024여야 하고 `max_tokens` 한도에 포함됩니다. `display`로 사고 내용의 표시 방식을 제어할 수 있습니다. `type: "adaptive"`에서는 요청 복잡도에 따라 Claude가 언제, 얼마나 확장 사고를 사용할지 동적으로 결정합니다. 이 경우에도 `display`로 사고 내용의 표시 방식을 제어할 수 있습니다. `type: "disabled"`에서는 확장 사고를 사용하지 않습니다.

모델이 제공된 도구를 사용하는 방식.

모델이 사용할 수 있는 도구의 정의.

[
  null
]

각 후속 토큰에 대해 상위 K개 옵션에서만 샘플링합니다.

0

핵 샘플링을 사용합니다.

0