Kimi K3 Webhook Guide — Use Synchronous API Responses
Kimi K3 does not need a webhook on 97AI.PRO because chat completions return synchronously from `https://97ai.97claude.com/api/chat`. Use normal HTTP retry logic, server-side logging, and idempotent request ids. Webhooks are mainly for long-running media generation tasks.
Recommended request flow
- Send the request from your backend to `https://97ai.97claude.com/api/chat`.
- Attach your own request id in logs so retries can be traced.
- Persist the final response, token/vector usage, credits, and balance when the request succeeds.
- Retry transient HTTP failures with exponential backoff; do not retry validation errors.
State handling
| State | Meaning | Action |
|---|---|---|
| REQUEST | Client sends one synchronous HTTP request | Keep a client request id for retry safety |
| SUCCESS | Kimi K3 returns the final response in the same call | Persist text, vectors, tokens, credits, or balance |
| ERROR | The HTTP request fails or times out | Retry with backoff and do not create duplicate billing records |
When a webhook still makes sense
If your product wraps Kimi K3 inside a longer workflow, send your own internal webhook after the synchronous API response succeeds. For example: embed documents, store vectors, then notify your indexing service that a collection is ready.
Frequently asked questions
Does Kimi K3 support webhook_url?+
No webhook URL is needed for Kimi K3 on 97AI.PRO. The response returns directly in the HTTP call.
How do I avoid duplicate billing on retries?+
Only retry network or 5xx failures, and store your own request id. 97AI.PRO bills only successful calls, but your app should still prevent duplicate downstream writes.
What timeout should I use?+
Use a timeout appropriate for your backend route and retry queue. For user-facing flows, run the call server-side and show a loading state.
Can I combine Kimi K3 with media webhooks?+
Yes. A common workflow is synchronous chat or embedding first, then async image/video generation with a webhook callback.
Do failed requests cost money?+
No. Failed chat completions cost $0 on 97AI.PRO.
Ready to try Kimi K3?
Sign up on 97AI.PRO, top up with credit card / USDC / Alipay, and get an API key in under 60 seconds.