Create Chat Completion

POST/v1/chat/completions

Create a model response using the OpenAI-compatible Chat Completions format.

Request Body

application/json

messages:requiredarray

Messages that make up the conversation.

model:requiredstring

Model identifier used for this request.

Allowedgpt-5.5

max_completion_tokens:optionalnumber

Maximum number of tokens allowed in the completion.

Example1024

reasoning_effort:optionalstring

Controls the amount of reasoning performed by supported models.

Allowednoneminimallowmediumhighxhighmax

Examplemedium

temperature:optionalnumber

Sampling temperature used to control response randomness.

Response

200

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

Request ExamplePOST /v1/chat/completions

Request example

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/chat/completions' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "gpt-5.5",7  "messages": [8    {9      "role": "developer",10      "content": "You are a helpful assistant."11    },12    {13      "role": "user",14      "content": "Hello!"15    }16  ]17}'

1const response = await fetch("https://api.unifyllm.top/v1/chat/completions", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "gpt-5.5",9    "messages": [10      {11        "role": "developer",12        "content": "You are a helpful assistant."13      },14      {15        "role": "user",16        "content": "Hello!"17      }18    ]19  }),20});21 22const data = await response.json();23console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/chat/completions",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "gpt-5.5",8      "messages": [9        {10          "role": "developer",11          "content": "You are a helpful assistant."12        },13        {14          "role": "user",15          "content": "Hello!"16        }17      ]18    }19)20response.raise_for_status()21print(response.json())

Request Body

1{2  "model": "gpt-5.5",3  "messages": [4    {5      "role": "developer",6      "content": "You are a helpful assistant."7    },8    {9      "role": "user",10      "content": "Hello!"11    }12  ]13}

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/chat/completions' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "gpt-5.5",7  "messages": [8    {9      "role": "user",10      "content": [11        {12          "type": "text",13          "text": "What is in this image?"14        },15        {16          "type": "image_url",17          "image_url": {18            "url": "https://example.com/reference-image.jpg"19          }20        }21      ]22    }23  ],24  "max_completion_tokens": 30025}'

1const response = await fetch("https://api.unifyllm.top/v1/chat/completions", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "gpt-5.5",9    "messages": [10      {11        "role": "user",12        "content": [13          {14            "type": "text",15            "text": "What is in this image?"16          },17          {18            "type": "image_url",19            "image_url": {20              "url": "https://example.com/reference-image.jpg"21            }22          }23        ]24      }25    ],26    "max_completion_tokens": 30027  }),28});29 30const data = await response.json();31console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/chat/completions",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "gpt-5.5",8      "messages": [9        {10          "role": "user",11          "content": [12            {13              "type": "text",14              "text": "What is in this image?"15            },16            {17              "type": "image_url",18              "image_url": {19                "url": "https://example.com/reference-image.jpg"20              }21            }22          ]23        }24      ],25      "max_completion_tokens": 30026    }27)28response.raise_for_status()29print(response.json())

Request Body

1{2  "model": "gpt-5.5",3  "messages": [4    {5      "role": "user",6      "content": [7        {8          "type": "text",9          "text": "What is in this image?"10        },11        {12          "type": "image_url",13          "image_url": {14            "url": "https://example.com/reference-image.jpg"15          }16        }17      ]18    }19  ],20  "max_completion_tokens": 30021}

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/chat/completions' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "gpt-5.5",7  "messages": [8    {9      "role": "developer",10      "content": "You are a helpful assistant."11    },12    {13      "role": "user",14      "content": "Hello!"15    }16  ],17  "stream": true18}'

1const response = await fetch("https://api.unifyllm.top/v1/chat/completions", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "gpt-5.5",9    "messages": [10      {11        "role": "developer",12        "content": "You are a helpful assistant."13      },14      {15        "role": "user",16        "content": "Hello!"17      }18    ],19    "stream": true20  }),21});22 23const data = await response.json();24console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/chat/completions",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "gpt-5.5",8      "messages": [9        {10          "role": "developer",11          "content": "You are a helpful assistant."12        },13        {14          "role": "user",15          "content": "Hello!"16        }17      ],18      "stream": true19    }20)21response.raise_for_status()22print(response.json())

Request Body

1{2  "model": "gpt-5.5",3  "messages": [4    {5      "role": "developer",6      "content": "You are a helpful assistant."7    },8    {9      "role": "user",10      "content": "Hello!"11    }12  ],13  "stream": true14}

1curl --request POST \2  --url 'https://api.unifyllm.top/v1/chat/completions' \3  --header 'Authorization: Bearer <YOUR_API_KEY>' \4  --header 'Content-Type: application/json' \5  --data '{6  "model": "gpt-5.5",7  "messages": [8    {9      "role": "user",10      "content": "What is the weather like in Boston today?"11    }12  ],13  "tools": [14    {15      "type": "function",16      "function": {17        "name": "get_current_weather",18        "description": "Get the current weather in a given location",19        "parameters": {20          "type": "object",21          "properties": {22            "location": {23              "type": "string",24              "description": "The city and state, e.g. San Francisco, CA"25            },26            "unit": {27              "type": "string",28              "enum": [29                "celsius",30                "fahrenheit"31              ]32            }33          },34          "required": [35            "location"36          ]37        }38      }39    }40  ],41  "tool_choice": "auto"42}'

1const response = await fetch("https://api.unifyllm.top/v1/chat/completions", {2  method: "POST",3  headers: {4    "Authorization": "Bearer <YOUR_API_KEY>",5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    "model": "gpt-5.5",9    "messages": [10      {11        "role": "user",12        "content": "What is the weather like in Boston today?"13      }14    ],15    "tools": [16      {17        "type": "function",18        "function": {19          "name": "get_current_weather",20          "description": "Get the current weather in a given location",21          "parameters": {22            "type": "object",23            "properties": {24              "location": {25                "type": "string",26                "description": "The city and state, e.g. San Francisco, CA"27              },28              "unit": {29                "type": "string",30                "enum": [31                  "celsius",32                  "fahrenheit"33                ]34              }35            },36            "required": [37              "location"38            ]39          }40        }41      }42    ],43    "tool_choice": "auto"44  }),45});46 47const data = await response.json();48console.log(data);

1import requests2 3response = requests.post(4    "https://api.unifyllm.top/v1/chat/completions",5    headers={"Authorization": "Bearer <YOUR_API_KEY>"},6    json={7      "model": "gpt-5.5",8      "messages": [9        {10          "role": "user",11          "content": "What is the weather like in Boston today?"12        }13      ],14      "tools": [15        {16          "type": "function",17          "function": {18            "name": "get_current_weather",19            "description": "Get the current weather in a given location",20            "parameters": {21              "type": "object",22              "properties": {23                "location": {24                  "type": "string",25                  "description": "The city and state, e.g. San Francisco, CA"26                },27                "unit": {28                  "type": "string",29                  "enum": [30                    "celsius",31                    "fahrenheit"32                  ]33                }34              },35              "required": [36                "location"37              ]38            }39          }40        }41      ],42      "tool_choice": "auto"43    }44)45response.raise_for_status()46print(response.json())

Request Body

1{2  "model": "gpt-5.5",3  "messages": [4    {5      "role": "user",6      "content": "What is the weather like in Boston today?"7    }8  ],9  "tools": [10    {11      "type": "function",12      "function": {13        "name": "get_current_weather",14        "description": "Get the current weather in a given location",15        "parameters": {16          "type": "object",17          "properties": {18            "location": {19              "type": "string",20              "description": "The city and state, e.g. San Francisco, CA"21            },22            "unit": {23              "type": "string",24              "enum": [25                "celsius",26                "fahrenheit"27              ]28            }29          },30          "required": [31            "location"32          ]33        }34      }35    }36  ],37  "tool_choice": "auto"38}

Response Example

200

1{2  "id": "resp_08ace07345c0a0f3016a55db3800d88194a08d05b7495c3a45",3  "object": "chat.completion",4  "created": 1784011576,5  "model": "gpt-5.5",6  "choices": [7    {8      "index": 0,9      "message": {10        "role": "assistant",11        "content": "Hello! How can I help you today?"12      },13      "finish_reason": "stop"14    }15  ],16  "usage": {17    "prompt_tokens": 28,18    "completion_tokens": 13,19    "total_tokens": 4120  }21}