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

Izprast atbildes formātu

Nodarbība 4 no 16 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Atbildes uzbūve
  2. Pilna struktūra
  3. Galvenie lauki
  4. Izprast usage objektu
  5. Rīku izmantošana servera pusē
  6. Teksta iegūšana Python valodā
  7. Galvenās atziņas

Atbildes uzbūve

Kad nosūti pieprasījumu uz POST /v1/responses, xAI serveris atgriež strukturētu JSON objektu. Lai pareizi izmantotu rezultātus savā lietotnē, ir būtiski saprast katru šī objekta lauku.

Pilna struktūra

Lūk, tipiska atbilde:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [
    {
      "type": "message",
      "content": [
        {
          "type": "output_text",
          "text": "Le machine learning est une branche de l'IA...",
          "annotations": []
        }
      ],
      "status": "completed"
    }
  ],
  "usage": {
    "input_tokens": 45,
    "output_tokens": 180,
    "total_tokens": 225,
    "output_tokens_details": {
      "reasoning_tokens": 120
    },
    "cost_in_nano_usd": 500000
  }
}

Galvenie lauki

id

Unikālais atbildes identifikators formātā resp-xxx. Tu to izmantosi, lai:

  • Savienotu sarunas, izmantojot previous_response_id
  • Iegūtu saglabātu atbildi ar GET /v1/responses/{id}
  • Dzēstu atbildi ar DELETE /v1/responses/{id}

status

Atbildes statuss:

StatussNozīme
completedAtbilde ģenerēta veiksmīgi
failedKļūda ģenerēšanas laikā
incompleteAtbilde pārtraukta (tokenu limits, satura filtrs)
in_progressNotiek ģenerēšana (straumēšana)

Vienmēr pārbaudi statusu, pirms izmanto atbildes saturu savā kodā.

output

Masīvs, kas satur atbildes elementus. Katram elementam ir type:

  • message: Modeļa teksta atbilde
  • function_call: Modeļa pieprasīts rīka izsaukums

Teksta saturs atrodas adresē output[0].content[0].text. Anotācijas (citāti, saites) ir tā paša objekta masīvā annotations.

usage

Lietošanas informācija, kas detalizēti aprakstīta tālāk.

Izprast usage objektu

Objekts usage ir kritiski svarīgs, lai izsekotu savas izmaksas:

{
  "input_tokens": 45,
  "output_tokens": 180,
  "total_tokens": 225,
  "output_tokens_details": {
    "reasoning_tokens": 120
  },
  "cost_in_nano_usd": 500000
}

Ievades un izvades tokeni

  • input_tokens: Tokenu skaits tavā uzvednē (un vēsturē, ja savieno sarunas)
  • output_tokens: Kopējais ģenerēto tokeni skaits, ieskaitot spriešanu
  • total_tokens: Abu summa

Spriešanas tokeni

output_tokens_details.reasoning_tokens norāda, cik tokenus modelis izmantoja savai iekšējai spriešanai. Par šiem tokeniem tiek iekasēta maksa, taču tie neparādās teksta atbildē.

Iepriekšējā piemērā no 180 izvades tokeniem 120 ir paredzēti spriešanai, un tikai 60 veido redzamo atbildi. Šī ir tipiska attiecība spriešanas modeļiem.

Izmaksas nano-USD

cost_in_nano_usd norāda precīzu pieprasījuma cenu. Konvertēšana ir vienkārša:

Izmaksas USD = cost_in_nano_usd / 1 000 000 000

Mūsu piemērā: 500000 / 1 000 000 000 = 0,0005 USD (0,0005 $).

Rīku izmantošana servera pusē

Kad modelis izmanto iebūvētos rīkus, objekts usage ietver arī:

{
  "server_side_tool_usage_details": {
    "web_search_calls": 2,
    "code_interpreter_calls": 0,
    "x_search_calls": 1,
    "document_search_calls": 0,
    "file_search_calls": 0,
    "mcp_calls": 0
  }
}

Tas ļauj precīzi uzzināt, kuri rīki tika izsaukti un cik reižu.

Teksta iegūšana Python valodā

Lūk, stabils paraugs teksta satura iegūšanai:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Explique les listes en Python."
)

# Pārbaudi statusu
if response.status == "completed":
    text = response.output[0].content[0].text
    print(text)
else:
    print(f"Error: status {response.status}")

# Parādi lietojumu
print(f"Tokens used: {response.usage.total_tokens}")
print(f"Cost: {response.usage.cost_in_nano_usd / 1e9:.6f} USD")

Galvenās atziņas

  • Katrai atbildei ir unikāls id, ko var atkārtoti izmantot savienošanai vai iegūšanai
  • Vienmēr pārbaudi status, pirms izmanto saturu
  • Teksts atrodas adresē output[0].content[0].text
  • Par reasoning_tokens tiek iekasēta maksa, taču tie atbildē nav redzami
  • cost_in_nano_usd, dalīts ar vienu miljardu, dod izmaksas dolāros