AI CHAT Function Call

The Taam API offers a powerful AI chat service that enables seamless integration of intelligent conversational agents into your applications.

Function Call

POST /v1/chat/completions

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Key	Example Value	Type	Required	Description
stream	false	Boolean	Yes	Whether to stream (typewriter effect)
messages	-	Array	Yes	List of messages in the conversation
messages.role	user	String	Yes	Role of the message sender (e.g., user)
messages.content	hello	String	Yes	Content of the message
model	gpt-4o	String	Yes	Model to be used for the conversation

json raw

{
    "stream": false,
    "messages": [
        {
            "role": "user",
            "content": "What's the weather like in New York today?"
        }
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_current_weather",
                "description": "Get the current weather in a given location",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "location": {
                            "type": "string",
                            "description": "The city and state, e.g. San Francisco, CA"
                        },
                        "unit": {
                            "type": "string",
                            "enum": [
                                "celsius",
                                "fahrenheit"
                            ]
                        }
                    },
                    "required": [
                        "location"
                    ]
                }
            }
        }
    ],
    "model": "gpt-4o-mini"
}

You can Get The List of AI models here here or visit Your Account in Taam API

Response

200

{
	"id": "chatcmpl-A2jJ1v77UvL5p3r9WHMVZf37POYtd",
	"object": "chat.completion",
	"created": 1725214176,
	"model": "gpt-4o-2024-05-13",
	"choices": [
		{
			"index": 0,
			"message": {
				"role": "assistant",
				"content": "",
				"tool_calls": [
					{
						"id": "call_yNASK0CfVmc0VNj1gTWCmTiq",
						"type": "function",
						"function": {
							"name": "get_current_weather",
							"arguments": "{\"location\":\"Beijing\",\"unit\":\"celsius\"}"
						}
					}
				]
			},
			"finish_reason": "tool_calls"
		}
	],
	"usage": {
		"prompt_tokens": 77,
		"completion_tokens": 21,
		"total_tokens": 98
	},
	"system_fingerprint": "fp_f5a70d8dc9"
}

400

{
  "error": "Invalid request"
}