Create Message

POST/v1/messages

Create a model response using the Anthropic-compatible Messages format.

Request Body

application/json

model:requiredstring

Model identifier used for this request.

messages:requiredarray

Messages that make up the conversation.

max_tokens:requiredinteger

Maximum number of tokens allowed in the generated message.

Example1024

stream:optionalboolean

Whether to stream partial results as they become available.

thinking:optionalobject

Extended thinking configuration for supported models.

Response

200

A successful request returns a JSON response. The complete example is shown in the code panel.

Request ExamplePOST /v1/messages

Request example

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/messages' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "claude-sonnet-5",7  "max_tokens": 1024,8  "messages": [9    {10      "role": "user",11      "content": "hi"12    }13  ]14}'

1const response = await fetch("https://api.unifyllm.top/v1/messages", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "claude-sonnet-5",9    "max_tokens": 1024,10    "messages": [11      {12        "role": "user",13        "content": "hi"14      }15    ]16  }),17});18 19const data = await response.json();20console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/messages",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "claude-sonnet-5",8      "max_tokens": 1024,9      "messages": [10        {11          "role": "user",12          "content": "hi"13        }14      ]15    }16)17response.raise_for_status()18print(response.json())

Request Body

1{2  "model": "claude-sonnet-5",3  "max_tokens": 1024,4  "messages": [5    {6      "role": "user",7      "content": "hi"8    }9  ]10}

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/messages' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "claude-sonnet-5",7  "max_tokens": 1024,8  "messages": [9    {10      "role": "user",11      "content": [12        {13          "type": "image",14          "source": {15            "type": "base64",16            "media_type": "image/jpeg",17            "data": "/9j/4AAQSkZJRg..."18          }19        },20        {21          "type": "text",22          "text": "What is in this image?"23        }24      ]25    }26  ]27}'

1const response = await fetch("https://api.unifyllm.top/v1/messages", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "claude-sonnet-5",9    "max_tokens": 1024,10    "messages": [11      {12        "role": "user",13        "content": [14          {15            "type": "image",16            "source": {17              "type": "base64",18              "media_type": "image/jpeg",19              "data": "/9j/4AAQSkZJRg..."20            }21          },22          {23            "type": "text",24            "text": "What is in this image?"25          }26        ]27      }28    ]29  }),30});31 32const data = await response.json();33console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/messages",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "claude-sonnet-5",8      "max_tokens": 1024,9      "messages": [10        {11          "role": "user",12          "content": [13            {14              "type": "image",15              "source": {16                "type": "base64",17                "media_type": "image/jpeg",18                "data": "/9j/4AAQSkZJRg..."19              }20            },21            {22              "type": "text",23              "text": "What is in this image?"24            }25          ]26        }27      ]28    }29)30response.raise_for_status()31print(response.json())

Request Body

1{2  "model": "claude-sonnet-5",3  "max_tokens": 1024,4  "messages": [5    {6      "role": "user",7      "content": [8        {9          "type": "image",10          "source": {11            "type": "base64",12            "media_type": "image/jpeg",13            "data": "/9j/4AAQSkZJRg..."14          }15        },16        {17          "type": "text",18          "text": "What is in this image?"19        }20      ]21    }22  ]23}

Response Example

200

1{2  "content": [3    {4      "text": "Hi! How can I help you today?",5      "type": "text"6    }7  ],8  "id": "msg_011iQWcVm0bi7WY0htDBWQ6U",9  "model": "claude-sonnet-5",10  "role": "assistant",11  "stop_reason": "end_turn",12  "stop_sequence": null,13  "type": "message",14  "usage": {15    "cache_creation": {16      "ephemeral_1h_input_tokens": 0,17      "ephemeral_5m_input_tokens": 018    },19    "cache_creation_input_tokens": 0,20    "cache_read_input_tokens": 157,21    "inference_geo": "not_available",22    "input_tokens": 54,23    "output_tokens": 11,24    "output_tokens_details": {25      "thinking_tokens": 026    },27    "service_tier": "standard"28  }29}