Claude Messages

# Claude Messages

Native Claude Messages-compatible API. This endpoint uses Anthropic Messages request and response shapes, including tool calls and Anthropic SSE events.

POST https://api.apihop.ai/anthropic/v1/messages

Native Claude Messages-compatible API. This endpoint uses Anthropic Messages request and response shapes, including tool calls and Anthropic SSE events.

Claude Sonnet 4.6 (`claude-sonnet-4-6`) is supported by the upstream supplier but is not currently published on RequestBeam. It is not an active integration default. Before calling any model, confirm access with your own `GET https://api.apihop.ai/v1/models` response.

```text
POST https://api.apihop.ai/anthropic/v1/messages
```

## Authentication

All requests require a RequestBeam API Key. Anthropic SDKs, Claude Code, and compatible clients usually use `x-api-key`; plain HTTP clients may also use Bearer Token authentication.

```http
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
```

```http
Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
```

## Body

### `model` (string, required, Default: claude-sonnet-5-5)

Supported Claude model IDs.

- `claude-fable-5`
- `claude-fable-5-1`
- `claude-opus-4-6`
- `claude-opus-4-7`
- `claude-opus-4-8`
- `claude-opus-5`
- `claude-opus-5-5`
- `claude-sonnet-5`
- `claude-sonnet-5-5`

Use `GET https://api.apihop.ai/v1/models` for the models currently available to your API Key.

### `max_tokens` (integer, required)

Maximum number of output tokens, as a positive safe integer. This budget includes both thinking and final text output tokens. Missing, zero, negative, fractional, string, or unsafe-integer values return HTTP `400` with `invalid_request_error` before generation or billing. The model may impose a lower maximum.

For models that produce thinking, a small budget such as `128` may yield only thinking blocks before ending with `stop_reason: "max_tokens"`, without text output. Set an explicit budget for the task and the selected model, allowing room for thinking and the final answer. The values in the examples are editable allowances, not upstream defaults or model limits; larger allowances may increase output usage and cost.

### `messages` (object[], required)

Conversation messages. Each message contains `role` and `content`.

`role` supports `user` and `assistant`. `content` may be a string or an array of content blocks.

### `system` (string | object[])

System prompt. Anthropic Messages uses a top-level `system` field instead of a `system` role in `messages`.

### `stream` (boolean, Default: false)

Whether to return Anthropic SSE events.

### `temperature` (number)

Sampling temperature. Accepted values and effects vary by the selected model.

### `top_p` (number)

Nucleus sampling parameter. Acceptance does not guarantee that it changes generation behavior.

### `top_k` (integer)

Top-k sampling parameter. Support depends on the selected model.

### `stop_sequences` (string[])

Stop sequences.

Requests with nonempty stop sequences avoid model services known not to support them; if no compatible service is available, the request returns `400` before generation or billing.

### `tools` (object[])

Anthropic tool definitions. Function tools usually include `name`, `description`, and `input_schema`.

### `tool_choice` (object)

Tool selection policy, such as `{ "type": "auto" }` or `{ "type": "tool", "name": "..." }`.

### `thinking` (object)

Native Anthropic thinking configuration, subject to the selected model and provider's support. Claude 4.5 uses `{ "type": "enabled", "budget_tokens": 1024 }`; Claude Sonnet/Opus 4.6 also support adaptive thinking. Do not apply a manual budget to every model version. In tool continuations, return the complete ordered assistant content, including `thinking`, `signature`, `redacted_thinking` and `tool_use`, unchanged. Keep the thinking configuration and required `anthropic-beta` headers consistent through the tool round trip. For SSE, concatenate `signature_delta.signature` fragments for the same content block; an empty thinking summary does not mean its signature can be discarded. A provider account access rejection is an upstream failure, not evidence of an invalid signature. Recognized Bedrock account access rejections return HTTP 502 with `api_error`; ordinary client validation errors retain HTTP 400. Acceptance still requires an enabled upstream account.

### `metadata` (object)

Request metadata.

### Prompt Caching

Add `cache_control: { "type": "ephemeral" }` to a `system` or message content block. Cache usage may include `cache_creation_input_tokens`, `cache_read_input_tokens`, and supported 5-minute or 1-hour creation buckets. A 1-hour TTL also requires the corresponding `anthropic-beta` header.

## Request Examples

### Non-Streaming

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, introduce yourself in one sentence."
    }
  ],
  "stream": false
}
```

### Streaming

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Reply exactly OK."
    }
  ],
  "stream": true
}
```

## Response

Non-streaming responses keep the Anthropic Message shape.

### `id` (string)

Response ID, such as `msg_...`.

### `type` (string)

Object type, usually `message`.

### `role` (string)

Usually `assistant`.

### `model` (string)

Actual Claude model used.

### `content` (object[])

Native output content blocks, including `text`, `tool_use`, and `thinking` when used.

### `stop_reason` (string)

Stop reason, such as `end_turn`, `max_tokens`, `stop_sequence`, or `tool_use`.

### `usage` (object)

Token usage, including `input_tokens` and `output_tokens`. Cache token fields are included when present.

### Success Example

```json
{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {
      "type": "text",
      "text": "Hello, I am Claude and can help with writing, coding, and analysis tasks."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "output_tokens": 24
  }
}
```

## Streaming Response

When `stream: true`, the endpoint returns Anthropic SSE events. Common events include:

- `message_start`
- `content_block_start`
- `content_block_delta`
- `content_block_stop`
- `ping`
- `message_delta`
- `message_stop`

## Error Response

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for the full code reference, protocol differences, and diagnostic steps.

Error responses use the Anthropic-style shape:

```json
{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid credentials or API key has expired."
  }
}
```

기본 Claude Messages 호환 API입니다. 이 엔드포인트는 도구 호출과 Anthropic SSE 이벤트를 포함한 Anthropic Messages 요청 및 응답 구조를 사용합니다.

상위 공급자는 Claude Sonnet 4.6(claude-sonnet-4-6)을 지원하지만 RequestBeam에는 현재 공개되지 않았습니다. 활성 연동의 기본 모델이 아닙니다. 모델을 호출하기 전에 자신의 GET https://api.apihop.ai/v1/models 응답으로 접근 가능 여부를 확인하세요.

text

POST https://api.apihop.ai/anthropic/v1/messages

인증

모든 요청에는 RequestBeam API 키가 필요합니다. Anthropic SDK, Claude Code 및 호환 클라이언트는 일반적으로 x-api-key를 사용하며 일반 HTTP 클라이언트는 Bearer 토큰 인증도 사용할 수 있습니다.

http

x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

http

Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

요청 본문

modelstring필수기본값: claude-sonnet-5-5

지원되는 Claude 모델 ID입니다.

claude-fable-5
claude-fable-5-1
claude-opus-4-6
claude-opus-4-7
claude-opus-4-8
claude-opus-5
claude-opus-5-5
claude-sonnet-5
claude-sonnet-5-5

GET https://api.apihop.ai/v1/models로 현재 API 키에서 사용할 수 있는 모델을 확인하세요.

max_tokensinteger필수

최대 출력 토큰 수로, 안전한 범위의 양의 정수여야 합니다. 이 예산에는 사고 과정과 최종 텍스트 출력 토큰이 모두 포함됩니다. 누락된 값, 0, 음수, 소수, 문자열 또는 안전하지 않은 정수는 생성이나 청구 전에 HTTP 400과 invalid_request_error를 반환합니다. 모델이 더 낮은 상한을 적용할 수 있습니다.

사고 과정을 생성하는 모델에서 128처럼 작은 예산은 사고 블록만 생성한 뒤 텍스트 출력 없이 stop_reason: "max_tokens"로 끝날 수 있습니다. 작업과 선택한 모델에 맞는 예산을 명시하고 사고 과정과 최종 답변을 위한 여유를 두세요. 예제 값은 수정 가능한 허용량이며 공급자 기본값이나 모델 한도가 아닙니다. 허용량을 늘리면 출력 사용량과 비용이 증가할 수 있습니다.

messagesobject[]필수

대화 메시지입니다. 각 메시지에는 role과 content가 포함됩니다.

role은 user와 assistant를 지원합니다. content는 문자열 또는 콘텐츠 블록 배열일 수 있습니다.

systemstring | object[]

시스템 프롬프트입니다. Anthropic Messages는 messages의 system 역할 대신 최상위 system 필드를 사용합니다.

streamboolean기본값: false

Anthropic SSE 이벤트 반환 여부입니다.

temperaturenumber

샘플링 온도입니다. 허용 값과 효과는 선택한 모델에 따라 다릅니다.

top_pnumber

뉴클리어스 샘플링 매개변수입니다. 수락되어도 생성 동작이 바뀐다는 보장은 없습니다.

top_kinteger

Top-k 샘플링 매개변수입니다. 지원 여부는 선택한 모델에 따라 다릅니다.

stop_sequencesstring[]

중지 시퀀스입니다.

비어 있지 않은 중지 시퀀스가 있는 요청은 이를 지원하지 않는 것으로 알려진 모델 서비스를 피합니다. 호환 서비스가 없으면 생성이나 청구 전에 400을 반환합니다.

toolsobject[]

Anthropic 도구 정의입니다. 함수 도구에는 일반적으로 name, description, input_schema가 포함됩니다.

tool_choiceobject

{ "type": "auto" } 또는 { "type": "tool", "name": "..." } 등의 도구 선택 정책입니다.

thinkingobject

선택한 모델과 공급자의 지원에 따라 적용되는 기본 Anthropic 사고 설정입니다. Claude 4.5는 { "type": "enabled", "budget_tokens": 1024 }를 사용하며 Claude Sonnet/Opus 4.6은 적응형 사고도 지원합니다. 모든 모델 버전에 수동 예산을 적용하지 마세요. 도구 후속 요청에서는 thinking, signature, redacted_thinking, tool_use를 포함한 전체 assistant 콘텐츠를 순서대로 변경 없이 반환하세요. 도구 왕복 과정에서 사고 설정과 필요한 anthropic-beta 헤더를 일관되게 유지하세요. SSE에서는 같은 콘텐츠 블록의 signature_delta.signature 조각을 이어 붙이세요. 사고 요약이 비어 있어도 서명을 버려도 된다는 뜻은 아닙니다. 공급자 계정 접근 거부는 상위 공급자 오류이며 잘못된 서명의 증거가 아닙니다. 식별된 Bedrock 계정 접근 거부는 HTTP 502와 api_error를 반환하며 일반 클라이언트 유효성 검사 오류는 HTTP 400을 유지합니다. 요청 수락에는 여전히 활성화된 상위 공급자 계정이 필요합니다.

metadataobject

요청 메타데이터입니다.

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, introduce yourself in one sentence."
    }
  ],
  "stream": false
}

스트리밍

json

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Reply exactly OK."
    }
  ],
  "stream": true
}

응답

비스트리밍 응답은 Anthropic Message 구조를 유지합니다.

idstring

msg_... 등의 응답 ID입니다.

typestring

객체 유형으로, 일반적으로 message입니다.

rolestring

일반적으로 assistant입니다.

modelstring

실제 사용된 Claude 모델입니다.

contentobject[]

text, tool_use 및 사용 시 thinking을 포함하는 기본 출력 콘텐츠 블록입니다.

stop_reasonstring

end_turn, max_tokens, stop_sequence 또는 tool_use 등의 중지 사유입니다.

usageobject

input_tokens와 output_tokens를 포함하는 토큰 사용량입니다. 캐시 토큰 필드가 있으면 함께 포함합니다.

성공 예제

json

{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {
      "type": "text",
      "text": "Hello, I am Claude and can help with writing, coding, and analysis tasks."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "output_tokens": 24
  }
}

스트리밍 응답

stream: true이면 엔드포인트는 Anthropic SSE 이벤트를 반환합니다. 일반적인 이벤트는 다음과 같습니다:

message_start
content_block_start
content_block_delta
content_block_stop
ping
message_delta
message_stop

오류 응답

전체 코드 참조, 프로토콜 차이 및 진단 절차는 오류 코드 및 문제 해결을 참조하세요.

오류 응답은 Anthropic 스타일 구조를 사용합니다:

json

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid credentials or API key has expired."
  }
}

인증

요청 본문

프롬프트 캐싱

요청 예제

비스트리밍

스트리밍

응답

성공 예제

스트리밍 응답

오류 응답