Izprast atbildes formātu
Šajā lapā
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:
| Statuss | Nozīme |
|---|---|
completed | Atbilde ģenerēta veiksmīgi |
failed | Kļūda ģenerēšanas laikā |
incomplete | Atbilde pārtraukta (tokenu limits, satura filtrs) |
in_progress | Notiek ģ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 atbildefunction_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šanutotal_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_tokenstiek iekasēta maksa, taču tie atbildē nav redzami cost_in_nano_usd, dalīts ar vienu miljardu, dod izmaksas dolāros