Проста заявка POST /v1/responses
На тази страница
Обновено на 3 ноември 2026 г. въз основа на най-добрите практики на xAI и справочника за API: температурата е ограничена до 1, а xAI препоръчва 0.7 със стойност на
top_pот 0.95. Източник: Най-добри практики.
Първото Ви успешно извикване
Вече разполагате с акаунт, API ключ и инсталиран SDK. Време е да изпратите първата си заявка към Grok API и да разберете структурата на отговора. Този урок се фокусира върху основния крайн пункт /v1/responses, който е най-модерният и най-препоръчителният.
Структура на заявката
Крайният пункт POST /v1/responses изисква поне два параметъра:
model: идентификаторът на модела, който ще използватеinput: текстът на Вашата заявка (или масив със съдържание за разширени случаи)
Минимална заявка на Python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="What's the most widely used programming language in 2026?"
)
print(response.output[0].content[0].text)
Със системни инструкции
Параметърът instructions Ви позволява да дефинирате поведението на модела:
response = client.responses.create(
model="grok-4.5",
instructions="You are a web development expert. Answer concisely.",
input="What's the difference between SSR and SSG?"
)
Анатомия на отговора
API връща структуриран JSON обект. Ето основните полета:
{
"id": "resp-abc123",
"object": "response",
"status": "completed",
"model": "grok-4.5",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "The model's answer appears here."
}
],
"status": "completed"
}
],
"usage": {
"input_tokens": 42,
"output_tokens": 156,
"total_tokens": 198
}
}
Важни полета
id: уникалният идентификатор на отговора, полезен за последващото му извличанеstatus:completed, когато генерирането приключиoutput: масив, съдържащ генерираните съобщенияusage: броячи на токени за проследяване на Вашето потребление
Често използвани незадължителни параметри
Контрол на креативността
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # стойността, препоръчана от xAI
top_p=0.95,
)
- API приема температура от 0 до 2, но ограничава всяка по-висока стойност до 1
- xAI препоръчва
temperature=0.7иtop_p=0.95и съветва да не се отклонявате от тях: качеството обикновено спада - За повече креативност поискайте това директно в подкана („предложи неочаквани имена“)
Ограничаване на дължината
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Ограничава отговора
)
Включване на разсъждения
За модели с възможност за разсъждение коригирайте усилието за мислене:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if 3x + 7 = 22, what is x?",
reasoning={"effort": "high"}
)
Възможните нива са low, medium и high.
Продължаване на разговор
Крайният пункт /v1/responses поддържа многократни разговори чрез параметъра previous_response_id:
# Първо съобщение
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Второ съобщение (моделът помни контекста)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Този подход е по-прост от ръчното управление на историята на съобщенията.
Проследяване на разходите
Полето usage в отговора Ви позволява да изчислите цената на всяко извикване. Полето output_tokens_details.reasoning_tokens показва колко токена са използвани за вътрешните разсъждения на модела (тези токени се таксуват, но не се появяват в отговора).
Ключови изводи
- Крайният пункт
POST /v1/responsesе най-модерният и най-препоръчителният - Два задължителни параметъра:
modelиinput - Отговорът се намира в
output[0].content[0].text - Използвайте
previous_response_idза многократни разговори - Полето
usageпомага за проследяване на потреблението на токени