Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

GET a DELETE: Správa odpovědí

Lekce 7 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Víc než jen vytváření
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Osvědčené postupy
  5. Klíčové poznatky

Víc než jen vytváření

API pro odpovědi se neomezuje pouze na jejich vytváření. Dva doplňkové endpointy ti umožňují načítat a mazat uložené odpovědi. Tyto operace jsou nezbytné pro budování robustních aplikací se správou historie.

GET /v1/responses/{id}

Načtení odpovědi

curl https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

API vrátí přesně stejný JSON objekt jako při vytváření:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Praktická využití

Obnovení konverzace: Tvá aplikace uloží poslední response_id do uživatelské relace. Při opětovném připojení načteš odpověď, abys zobrazil předchozí kontext.

# Uživatel se vrací po přestávce
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Zobrazit poslední výměnu
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Pokračovat v konverzaci
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Audit nákladů: Projdi své uložené odpovědi a analyzuj spotřebu podle uživatele nebo funkce.

response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")

Zpracování chyb

Pokud odpověď neexistuje (byla smazána nebo vypršela), API vrátí chybu 404:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Tento případ ošetři ve svém kódu:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Zahájit novou konverzaci

DELETE /v1/responses/{id}

Smazání odpovědi

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

Při úspěchu vrátí operace mazání stav 200. Tato operace je nevratná.

Dopad na řetězené konverzace

Když smažeš odpověď, na kterou odkazují jiné prostřednictvím previous_response_id, kontext této odpovědi z řetězce zmizí. Následné odpovědi se nesmažou, ale ztratí přístup k předchozímu kontextu.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ deleted

Pokud smažeš resp-2, resp-3 a resp-4 stále existují, ale kontext z resp-1 a resp-2 již není pro nové řetězené požadavky dostupný.

Automatizovaný úklid

Pro produkční aplikace implementuj pravidelný úklid:

import datetime

def cleanup_old_responses(response_ids, max_age_days=7):
    for rid in response_ids:
        try:
            resp = client.responses.retrieve(rid)
            age = datetime.datetime.now().timestamp() - resp.created_at
            if age > max_age_days * 86400:
                client.responses.delete(rid)
                print(f"Deleted: {rid}")
        except Exception:
            pass  # Již smazáno nebo vypršelo

Osvědčené postupy

  • Ukládej ID: uchovávej response_id ve své databázi spolu s metadaty konverzace
  • Pravidelně uklízej: nečekej na automatické vypršení po 30 dnech u citlivých dat
  • Ošetřuj chyby 404: odpověď může mezi požadavky zmizet (vypršení, ruční smazání)
  • Dokumentuj své řetězce: pro ladění sleduj odkazy previous_response_id mezi svými odpověďmi

Klíčové poznatky

  • GET /v1/responses/{id} načte odpověď s veškerým jejím obsahem a metadaty
  • DELETE /v1/responses/{id} trvale smaže odpověď – jde o nevratnou operaci
  • Smazání prostřední odpovědi přeruší kontext řetězce konverzace
  • Ošetřuj chyby 404: odpovědi automaticky vyprší po 30 dnech
  • Uchovávej response_id ve vlastní databázi pro sledovatelnost