Responses API и function_call_output
На тази страница
Responses API: новият крайна точка (endpoint)
Responses API е новата основна крайна точка на xAI, различна от съвместимата с OpenAI крайна точка за Chat Completions. Тя въвежда различен формат за извикване на функции, използвайки типа function_call_output за връщане на резултати от инструменти.
Разлики спрямо Chat Completions
Крайната точка Chat Completions (съвместима с OpenAI) използва съобщения с роля tool за връщане на резултати. Responses API използва различен формат, структуриран около типове събития.
Chat Completions (стар формат)
# Връщане на резултата чрез съобщение с роля "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
Responses API (нов формат)
# Връщане на резултата чрез обект function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Основни разлики:
type: "function_call_output"заместваrole: "tool"call_idзаместваtool_call_idoutputзаместваcontent
Използване на Responses API със SDK на OpenAI
Можете да използвате SDK на OpenAI, за да извикате Responses API на xAI:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Създаване на отговор с инструменти
response = client.responses.create(
model="grok-4.5",
input="What's the weather like in Paris?",
tools=[{
"type": "function",
"name": "get_weather",
"description": "Get the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}]
)
Имайте предвид, че Responses API използва input вместо messages, а структурата на инструментите е леко различна (липсва вложен обект function).
Обработка на отговора
Отговорът от Responses API съдържа масив output със събития:
for item in response.output:
if item.type == "function_call":
print(f"Function: {item.name}")
print(f"Arguments: {item.arguments}")
print(f"Call ID: {item.call_id}")
# Изпълнение на функцията
result = get_weather(city="Paris")
# Продължаване на разговора с резултата
follow_up = client.responses.create(
model="grok-4.5",
input=[
{"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(result)}
],
tools=tools,
previous_response_id=response.id
)
Полето previous_response_id
Responses API въвежда механизъм за верижно свързване на разговори чрез previous_response_id. Вместо да изпращате отново цялата история на съобщенията, просто правите препратка към предишния отговор:
# Първа заявка
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Втора заявка (свързана)
response2 = client.responses.create(
model="grok-4.5",
input=[{
"type": "function_call_output",
"call_id": response1.output[0].call_id,
"output": {temp: 22}
}],
previous_response_id=response1.id
)
Това опростява управлението на контекста и намалява размера на заявките.
Съхранение на съобщенията на сървъра
При store_messages=True, xAI съхранява съобщенията на своите сървъри:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
В комбинация с previous_response_id, това Ви позволява да поддържате дълги разговори, без да изпращате отново пълната история при всяка заявка.
Кога да използвате Responses API?
За нов проект, изграден специално върху xAI, Responses API е изборът по подразбиране поради няколко натрупващи се причини. Иновациите пристигат тук първи – новите функции се добавят към Responses API преди всякъде другаде, понякога ексклузивно. Някои вградени сървърни инструменти са достъпни само чрез този канал. А за дълги разговори, верижното свързване чрез previous_response_id е структурно по-ефективно от повторното изпращане на пълната история при всеки ход: по-малко прехвърлени токени, по-малко код за управление на състоянието от Ваша страна.
Chat Completions запазва две силни приложения: съществуващ код, написан за API на OpenAI, който работи както си е, чрез промяна на базовия URL, и проекти с множество доставчици, където преносимостта има приоритет – в тези ситуации съвместимостта надделява над ексклузивните функции.
Ключови изводи
- Responses API използва
function_call_outputвместо ролятаtool - Полетата се променят:
call_idвместоtool_call_id,outputвместоcontent previous_response_idВи позволява да свързвате разговори, без да изпращате отново историятаstore_messages=Trueактивира съхранение на сървъра- Responses API е препоръчителната крайна точка за нови проекти на xAI
- Chat Completions остава наличен за обратна съвместимост с OpenAI