Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Vienkāršs POST /v1/responses pieprasījums

Nodarbība 9 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Tavs pirmais veiksmīgais izsaukums
  2. Pieprasījuma struktūra
  3. Atbildes uzbūve
  4. Bieži lietoti opcionālie parametri
  5. Sarunas turpināšana
  6. Izmaksu izsekošana
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI labākajām praksēm un API atsauces dokumentāciju: temperatūra ir ierobežota līdz 1, un xAI iesaka izmantot 0.7 ar top_p vērtību 0.95. Avots: Labākās prakses.

Tavs pirmais veiksmīgais izsaukums

Tev ir konts, API atslēga un instalēts SDK. Ir laiks nosūtīt savu pirmo pieprasījumu Grok API un saprast atbildes struktūru. Šī nodarbība fokusējas uz galveno galapunktu /v1/responses, kas ir vismodernākais un visvairāk ieteicamais.

Pieprasījuma struktūra

Galapunkts POST /v1/responses pieņem vismaz divus parametrus:

  • model: izmantojamā modeļa ID
  • input: tava pieprasījuma teksts (vai satura masīvs sarežģītākos gadījumos)

Minimāls pieprasījums Python valodā

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)

Ar sistēmas instrukcijām

Parametrs instructions ļauj definēt modeļa uzvedību:

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?"
)

Atbildes uzbūve

API atgriež strukturētu JSON objektu. Lūk, galvenie lauki:

{
  "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
  }
}

Svarīgi lauki

  • id: unikālais atbildes ID, noderīgs tās vēlākai izgūšanai
  • status: completed, kad ģenerēšana ir pabeigta
  • output: masīvs, kas satur ģenerētos ziņojumus
  • usage: tokena skaitītāji tava patēriņa izsekošanai

Bieži lietoti opcionālie parametri

Kreativitates kontrole

response = client.responses.create(
    model="grok-4.5",
    input="Suggest a name for an AI startup.",
    temperature=0.7,  # vērtība, ko iesaka xAI
    top_p=0.95,
)
  • API pieņem temperatūru no 0 līdz 2, bet jebkuru augstāku vērtību ierobežo līdz 1
  • xAI iesaka temperature=0.7 un top_p=0.95 un attur no novirzīšanās no šīm vērtībām: kvalitāte parasti pasliktinās
  • Lai panāktu lielāku kreativitati, lūdz to tieši promptā („iedomājies negaidītus nosaukumus”)

Garuma ierobežošana

response = client.responses.create(
    model="grok-4.5",
    input="Summarize the concept of machine learning.",
    max_output_tokens=200  # Ierobežo atbildi
)

Spriešanas spēju aktivizēšana

Spriešanas modeļiem pielāgo domāšanas intensitāti:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Solve this problem: if 3x + 7 = 22, what is x?",
    reasoning={"effort": "high"}
)

Iespējamie līmeņi ir low, medium un high.

Sarunas turpināšana

Galapunkts /v1/responses atbalsta daudzpakāpju sarunas, izmantojot parametru previous_response_id:

# Pirmais ziņojums
r1 = client.responses.create(
    model="grok-4.5",
    input="I'm building an API in Python."
)

# Otrais ziņojums (modelis atceras kontekstu)
r2 = client.responses.create(
    model="grok-4.5",
    input="Which framework do you recommend?",
    previous_response_id=r1.id
)

Šī pieeja ir vienkāršāka nekā ziņojumu vēstures pārvaldīšana pašrocīgi.

Izmaksu izsekošana

Lauks usage atbildē ļauj aprēķināt katra izsaukuma izmaksas. Lauks output_tokens_details.reasoning_tokens parāda, cik tokeni tika izmantoti modeļa iekšējai spriešanai (šie tokeni tiek apmaksāti, bet neparādās atbildē).

Galvenās atziņas

  • Galapunkts POST /v1/responses ir vismodernākais un visvairāk ieteicamais
  • Divi obligāti parametri: model un input
  • Atbilde atrodama output[0].content[0].text
  • Daudzpakāpju sarunām izmanto previous_response_id
  • Lauks usage palīdz izsekot tava tokena patēriņu