Messages

Anthropic Messages API — required by Claude Code.

Create a message (Anthropic Messages API)

POST

https://api.hyphen-solution.com

/v1/messages

Anthropic-compatible Messages API. Required by Claude Code (ANTHROPIC_BASE_URL points here). The gateway accepts Anthropic-format requests and translates to the upstream provider.

Create a message (Anthropic Messages API) › Headers

anthropic-version

string

Forwarded through to the upstream Anthropic-compatible model.

Create a message (Anthropic Messages API) › Request Body

MessagesRequest

model

ModelAlias · enum · required

A Hyphen model. Use a real model ID (m2.5, m2.7, m3, text) or one of the stable aliases that map onto them (hyphen-fast = m2.5, hyphen-sonnet = m2.7, hyphen-opus = m3).

Enum values:

m2.5

m2.7

text

hyphen-fast

hyphen-sonnet

hyphen-opus

max_tokens

integer · min: 1 · required

object[] · required

system

string

Optional system prompt.

Create a message (Anthropic Messages API) › Responses

An Anthropic-format message.

MessagesResponse

id

string

type

string

role

string

model

string

object[]

stop_reason

string

object

POST/v1/messages

curl https://api.hyphen-solution.com/v1/messages \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "model": "m3",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Explain what a gateway does, briefly."
    }
  ]
}'

Example Request Body

{
  "model": "m3",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Explain what a gateway does, briefly."
    }
  ]
}

json

application/json

Example Responses

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "m3",
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0
  }
}

json

application/json

Responses Models

Create a message (Anthropic Messages API)

POST

https://api.hyphen-solution.com

/v1/messages

Anthropic-compatible Messages API. Required by Claude Code (ANTHROPIC_BASE_URL points here). The gateway accepts Anthropic-format requests and translates to the upstream provider.

Create a message (Anthropic Messages API) › Headers

anthropic-version

string

Forwarded through to the upstream Anthropic-compatible model.

Create a message (Anthropic Messages API) › Request Body

MessagesRequest

model

ModelAlias · enum · required

A Hyphen model. Use a real model ID (m2.5, m2.7, m3, text) or one of the stable aliases that map onto them (hyphen-fast = m2.5, hyphen-sonnet = m2.7, hyphen-opus = m3).

Enum values:

m2.5

m2.7

text

hyphen-fast

hyphen-sonnet

hyphen-opus

max_tokens

integer · min: 1 · required

object[] · required

system

string

Optional system prompt.

Create a message (Anthropic Messages API) › Responses

An Anthropic-format message.

MessagesResponse

id

string

type

string

role

string

model

string

object[]

stop_reason

string

object