Críochnuithe Comhrá vs API Freagraí: Comparáid
Ar an leathanach seo
Dhá chríochphointe, dhá fhealsúnacht
Tairgeann xAI dhá chríochphointe chun idirghníomhú le samhlacha Grok: Críochnuithe Comhrá (/v1/chat/completions) agus an API Freagraí (/v1/responses). Tá sé ríthábhachtach na difríochtaí eatarthu a thuiscint chun an críochphointe ceart a roghnú do do thionscadal agus chun aon aistriú féideartha a phleanáil.
| Gné | Críochnuithe Comhrá | API Freagraí |
|---|---|---|
| Stádas | Seanbhunaithe (Legacy) | Príomhúil (molta) |
| Bainistiú stáit | Gan stát (seol an stair) | Le stát (previous_response_id) |
| Stóráil freastalaí | Níl | Tá (30 lá le store: true) |
| Comhrá | Eagar teachtaireachtaí | Slabhraithe de réir ID |
| Uirlisí freastalaí | Glao feidhme amháin | web_search, x_search, code_interpreter, functions |
| Réasúnaíocht chriptithe | Níl | Tá (encrypted_content) |
| Gnéithe nua | Ní thugtar tosaíocht dóibh | Tugtar tosaíocht dóibh |
| Comhoiriúnacht OpenAI | Lán | Páirteach |
Bainistiú stáit: an difríocht bhunúsach
Críochnuithe Comhrá: is tusa a bhainistíonn an stair
Le gach iarratas, caithfidh tú an comhrá iomlán a athsheoladh:
# Críochnuithe Comhrá — athsheol gach rud gach uair
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello, my name is Alice."},
{"role": "assistant", "content": "Hello Alice! How can I help you?"},
{"role": "user", "content": "What is my first name?"}
]
)
API Freagraí: bainistíonn an freastalaí an stair
Leis an API Freagraí, is leor aitheantóir simplí chun comhrá a leanúint:
# API Freagraí — ní ach ID an fhreagra roimhe seo
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Hello, my name is Alice."
)
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is my first name?",
previous_response_id=response1.id
)
Coinníonn an freastalaí an comhthéacs agus athchruthaíonn sé an stair go huathoibríoch. Ní íocann tú níos lú tócan (bíonn an stair fós iníoctha), ach déanann tú do chód a shimpliú agus laghdaíonn tú méid do chuid iarratas.
Uirlisí agus gnéithe eisiacha
Tugann an API Freagraí rochtain ar uirlisí freastalaí nach dtairgeann Críochnuithe Comhrá:
web_search: cuardach gréasáin i bhfíor-amx_search: cuardach laistigh de phoist X (Twitter)code_interpreter: feidhmiú cód Python taobh freastalaí
Tá na huirlisí seo comhtháite go díreach san iarratas:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Tacaíonn Críochnuithe Comhrá le glao feidhme (uirlisí sainithe ag an bhforbróir), ach ní thacaíonn sé leis na huirlisí freastalaí seo a bhainistíonn xAI.
Cathain Críochnuithe Comhrá a úsáid?
Is é Críochnuithe Comhrá fós an rogha cheart i roinnt cásanna:
- Aistriú ó OpenAI: oibríonn do chód atá ann cheana gan mórán athraithe
- Ilsholáthraí: ba mhaith leat aistriú idir OpenAI, Anthropic, agus xAI leis an gcód céanna
- Creatláir tríú páirtí: Úsáideann LangChain, LlamaIndex, Haystack, agus an chuid is mó de na creatláir formáid Críochnuithe Comhrá
- Rialú iomlán: ba mhaith leat an stair a bhainistiú leat féin (achoimriú, scagadh, modhnú)
Cathain an API Freagraí a úsáid?
Is fearr an API Freagraí do:
- Tionscadail nua: bain tairbhe as na gnéithe is déanaí ón tús
- Uirlisí freastalaí: teastaíonn cuardach gréasáin, feidhmiú cód, nó cuardach X uait
- Comhráite fada: ní gá an stair a athsheoladh le gach iarratas
- Réasúnaíocht chriptithe: rochtain ar ábhar réasúnaíochta le haghaidh leanúnachais idir iarratais
Príomhphointí
- Tá Críochnuithe Comhrá gan stát (bainistíonn tusa an stair), tá an API Freagraí le stát (bainistíonn an freastalaí é)
- Tairgeann an API Freagraí uirlisí freastalaí eisiacha: web_search, x_search, code_interpreter
- Tá comhoiriúnacht iomlán OpenAI ag Críochnuithe Comhrá, tá an API Freagraí sonrach do xAI
- Gearrann an dá chríochphointe táille ar stair an chomhrá iomláin
- Úsáid Críochnuithe Comhrá le haghaidh comhoiriúnachta, agus an API Freagraí le haghaidh gnéithe nua