Przejdź do głównej treści
Polski— Wybierz język
Menu

GET i DELETE: Zarządzanie odpowiedziami

Lekcja 7 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Poza tworzeniem
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Najlepsze praktyki
  5. Kluczowe wnioski

Poza tworzeniem

API Responses nie służy wyłącznie do generowania nowych odpowiedzi. Dwa uzupełniające się punkty końcowe pozwalają na pobieranie i usuwanie zapisanych odpowiedzi. Operacje te są kluczowe dla budowania solidnych aplikacji z funkcją zarządzania historią.

GET /v1/responses/{id}

Pobieranie odpowiedzi

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

API zwraca dokładnie ten sam obiekt JSON, co podczas tworzenia:

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

Praktyczne przypadki użycia

Wznawianie konwersacji: Twoja aplikacja przechowuje ostatni response_id w sesji użytkownika. Po ponownym połączeniu pobierz odpowiedź, aby wyświetlić poprzedni kontekst.

# Użytkownik wraca po przerwie
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Wyświetl ostatnią wymianę
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Kontynuuj konwersację
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Audyt kosztów: Iteruj przez zapisane odpowiedzi, aby przeanalizować zużycie w podziale na użytkownika lub funkcję.

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

Obsługa błędów

Jeśli odpowiedź nie istnieje (została usunięta lub wygasła), API zwraca błąd 404:

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

Obsłuż ten przypadek w swoim kodzie:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Rozpocznij nową konwersację

DELETE /v1/responses/{id}

Usuwanie odpowiedzi

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

Pomyślne usunięcie zwraca status 200. Operacja jest nieodwracalna.

Wpływ na powiązane konwersacje

Gdy usuniesz odpowiedź, do której odwołują się inne poprzez previous_response_id, kontekst tej odpowiedzi znika z łańcucha. Kolejne odpowiedzi nie są usuwane, ale tracą dostęp do wcześniejszego kontekstu.

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

Jeśli usuniesz resp-2, odpowiedzi resp-3 i resp-4 nadal istnieją, ale kontekst z resp-1 i resp-2 staje się niedostępny dla nowych żądań w łańcuchu.

Automatyczne czyszczenie

W aplikacjach produkcyjnych wdróż okresowe czyszczenie danych:

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  # Już usunięte lub wygasłe

Najlepsze praktyki

  • Przechowuj identyfikatory: zapisuj response_id w swojej bazie danych wraz z metadanymi konwersacji.
  • Regularnie czyść dane: nie czekaj na automatyczne wygaśnięcie po 30 dniach w przypadku danych wrażliwych.
  • Obsługuj błędy 404: odpowiedź może zniknąć między żądaniami (wygaśnięcie, ręczne usunięcie).
  • Dokumentuj swoje łańcuchy: w celach debugowania śledź połączenia previous_response_id między odpowiedziami.

Kluczowe wnioski

  • GET /v1/responses/{id} pobiera odpowiedź wraz z całą jej zawartością i metadanymi.
  • DELETE /v1/responses/{id} trwale usuwa odpowiedź – jest to operacja nieodwracalna.
  • Usunięcie odpowiedzi pośredniej przerywa kontekst łańcucha konwersacji.
  • Obsługuj błędy 404: odpowiedzi wygasają automatycznie po 30 dniach.
  • Przechowuj response_id we własnej bazie danych dla zapewnienia możliwości śledzenia.