Премини към основното съдържание
Български— Изберете език
Меню

Проста заявка POST /v1/responses

Урок 9 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Първото Ви успешно извикване
  2. Структура на заявката
  3. Анатомия на отговора
  4. Често използвани незадължителни параметри
  5. Продължаване на разговор
  6. Проследяване на разходите
  7. Ключови изводи

Обновено на 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 помага за проследяване на потреблението на токени