GET ja DELETE: Vastausten hallinta
Tällä sivulla
Luomisen tuolla puolen
Responses API ei rajoitu pelkästään vastausten luomiseen. Kaksi täydentävää päätepistettä mahdollistavat tallennettujen vastausten noutamisen ja poistamisen. Nämä toiminnot ovat välttämättömiä historiahallinnan tarjoavien robustien sovellusten rakentamisessa.
GET /v1/responses/{id}
Vastauksen noutaminen
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API palauttaa täsmälleen saman JSON-objektin kuin luontivaiheessa:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Käytännön käyttötapaukset
Keskustelun jatkaminen: Sovelluksesi tallentaa viimeisimmän response_id:n käyttäjäistuntoon. Yhteyden muodostuessa uudelleen noudat vastauksen näyttääksesi edellisen kontekstin.
# Käyttäjä palaa tauon jälkeen
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Näytä viimeisin vaihto
print(f"Viimeisin vastaus: {previous.output[0].content[0].text[:200]}...")
# Jatka keskustelua
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Missä jäimme?",
previous_response_id=last_response_id
)
Kustannusauditointi: Käy läpi tallennetut vastauksesi analysoidaksesi kulutusta käyttäjäkohtaisesti tai ominaisuuskohtaisesti.
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"Kustannus: ${cost_usd:.6f} | Sisään: {input_tokens} | Ulos: {output_tokens}")
Virheenkäsittely
Jos vastausta ei ole olemassa (se on poistettu tai vanhentunut), API palauttaa 404-virheen:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Käsittele tämä tilanne koodissasi:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Vastausta ei löytynyt: {e}")
# Aloita uusi keskustelu
DELETE /v1/responses/{id}
Vastauksen poistaminen
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Poistaminen palauttaa onnistuessaan tilakoodin 200. Toiminto on palautumaton.
Vaikutus ketjutettuihin keskusteluihin
Kun poistat vastauksen, johon muut viittaavat previous_response_id:n kautta, kyseisen vastauksen konteksti katoaa ketjusta. Myöhempiä vastauksia ei poisteta, mutta ne menettävät pääsyn edeltävään kontekstiin.
resp-1 → resp-2 → resp-3 → resp-4
↑ poistettu
Jos poistat resp-2:n, resp-3 ja resp-4 ovat edelleen olemassa, mutta konteksti resp-1:stä ja resp-2:sta ei ole enää saatavilla uusiin ketjutettuihin pyyntöihin.
Automatisoitu siivous
Tuotantosovelluksille kannattaa toteuttaa säännöllinen siivous:
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"Poistettu: {rid}")
except Exception:
pass # Jo poistettu tai vanhentunut
Parhaat käytännöt
- Tallenna ID:t: säilytä
response_id:t tietokannassasi yhdessä keskustelun metatietojen kanssa - Siivoa säännöllisesti: älä odota automaattista 30 päivän vanhenemista arkaluonteisen datan kohdalla
- Käsittele 404-virheet: vastaus voi kadota pyyntöjen välillä (vanheneminen, manuaalinen poisto)
- Dokumentoi ketjusi: vianetsintää varten jäljitä
previous_response_id-linkit vastaustesi välillä
Keskeiset asiat
GET /v1/responses/{id}noutaa vastauksen koko sisällön ja metatietoineenDELETE /v1/responses/{id}poistaa vastauksen pysyvästi – palautumaton toiminto- Välivastauksen poistaminen katkaisee keskusteluketjun kontekstin
- Käsittele 404-virheet: vastaukset vanhenevat automaattisesti 30 päivän jälkeen
- Säilytä
response_id:t omassa tietokannassasi jäljitettävyyden varmistamiseksi