POST
/
anthropic
/
{region}
/
v1
/
messages
curl --request POST \
  --url https://api.langdock.com/anthropic/{region}/v1/messages \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "max_tokens": 1024,
  "messages": [
    {
      "content": "Write a haiku about cats.",
      "role": "user"
    }
  ],
  "model": "claude-3-haiku-20240307"
}'
[
  {
    "content": [
      {
        "text": "Here is a haiku about cats:\\n\\nFeline grace and charm,\\nPurring softly by the fire,\\nCats reign supreme.",
        "type": "text"
      }
    ],
    "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
    "model": "claude-3-haiku-20240307",
    "role": "assistant",
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "type": "message",
    "usage": {
      "input_tokens": 14,
      "output_tokens": 35
    }
  }
]

Creates a model response for the given chat conversation. This endpoint follows the Anthropic API specification and the requests are sent to the AWS Bedrock Anthropic endpoint.

To use the API you need an API key. Admins can create API keys in the settings.

All parameters from the Anthropic “Create a message” endpoint are supported according to the Anthropic specifications, with the following exception:

  • model: The supported models depend on the region, currently the following models are supported in the EU: claude-3-7-sonnet-20250219, claude-3-5-sonnet-20240620, claude-3-sonnet-20240229, claude-3-haiku-20240307 and the following models are supported in the US: claude-3-5-sonnet-20240620, claude-3-haiku-20240307, claude-3-opus-20240229.
  • The list of available models might differ if you are using your own API keys in Langdock (“Bring-your-own-keys / BYOK”, see here for details). In this case, please reach out to your admin to understand which models are available in the API.

​
Rate limits

The rate limit for the Messages endpoint is 500 RPM (requests per minute) and 60.000 TPM (tokens per minute). Rate limits are defined at the workspace level - and not at an API key level. Each model has its own rate limit. If you exceed your rate limit, you will receive a 429 Too Many Requests response.

Please note that the rate limits are subject to change, refer to this documentation for the most up-to-date information. In case you need a higher rate limit, please contact us at support@langdock.com.

​
Using Anthropic-compatible libraries

As the request and response format is the same as the Anthropic API, you can use popular libraries like the Anthropic Python library or the Vercel AI SDK to use the Langdock API.

​
Example using the Anthropic Python library

from anthropic import Anthropic
client = Anthropic(
  base_url="https://api.langdock.com/anthropic/eu/",
  api_key="<YOUR_LANGDOCK_API_KEY>"
)

message = client.messages.create(
	model="claude-3-haiku-20240307",
	messages=[
			{ "role": "user", "content": "Write a haiku about cats" }
	],
	max_tokens=1024,
)

print(message.content[0].text)

​
Example using the Vercel AI SDK in Node.js

import { generateText } from "ai";
import { createAnthropic } from "@ai-sdk/anthropic";

const langdockProvider = createAnthropic({
  baseURL: "https://api.langdock.com/anthropic/eu/v1",
  apiKey: "<YOUR_LANGDOCK_API_KEY>",
});

const result = await generateText({
  model: langdockProvider("claude-3-haiku-20240307"),
  prompt: "Write a haiku about cats",
});

console.log(result.text);

Headers

​
Authorization
string
required

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Path Parameters

​
region
enum<string>
required

The region of the API to use.

Available options:
eu,
us

Body

application/json

Response

200
application/json

Message object.

The response is of type object.