Messages

Use the Messages route for clients that send the Messages API request shape, including Claude Code and gateways that expect /v1/messages. Messages is an API surface, just like Chat Completions and Responses.

POST /v1/messages

Request

curl https://api.voxvey.com/v1/messages \
  -H "Authorization: Bearer $VOXVEY_TOKEN" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "<messages-model-id>",
    "max_tokens": 256,
    "messages": [
      {
        "role": "user",
        "content": "Reply with the exact word ready."
      }
    ]
  }'

Replace <messages-model-id> with a model returned by /v1/models for the Messages API.

Example response

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "<messages-model-id>",
  "content": [
    {
      "type": "text",
      "text": "ready"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 1
  }
}

Client setup

Use these pages for agent and editor configuration:

Client	Page
Claude Code	Claude Code setup
OpenClaw	OpenClaw setup
VS Code	VS Code setup

Notes

• Messages clients usually set their base URL to https://api.voxvey.com because they append /v1/messages themselves.
• OpenAI-compatible clients usually set their base URL to https://api.voxvey.com/v1.
• Forward version and beta headers when your Messages client sends them.