How long are call logs kept, and when are they cleared?
APIYI stores only what billing requires — never your inputs or outputs. Logs cover the current month plus the two preceding calendar months, with older months cleared on the 5th; export them yourself for long-term records.
Logs contain timestamps, model, token counts and amounts — the fields billing needs. Your inputs and outputs are never stored.
Current month + two prior
Cleanup runs on the 5th of each month and removes older whole months. Example: on 5 August the whole of May is cleared, leaving June, July and August queryable.
Export for long-term records
Use async export in the Logs section of the console and archive the file yourself for reconciliation and audits.
Cleanup is irreversible. Cleared logs cannot be recovered. If you need them for reconciliation, audits or expense claims, export before the cleanup date.
We keep only what billing and troubleshooting require. That is both a privacy-minimization principle and a direct reduction of the surface area for any data leak. For what each column means, see how to read the billing amounts in the logs.
Can I see generated images and videos in the console?
This is the most common follow-up question, and the answer depends on how the call was made:
Synchronous calls: no
Results from synchronous text and image endpoints are returned straight to your program and never stored. The console sees neither the prompt nor the generated image.
Async tasks: yes, but links expire quickly
Video and other async tasks work on a submit-then-poll model, so the result must be held temporarily to be queryable — which means the artifact is visible.
OSS links for async task artifacts last about one day. Video and image download URLs expire after roughly 24 hours and cannot be retrieved afterwards. Transfer results to your own storage as soon as you receive them — do not use these temporary links in production or hand them to end users.
Logs are cleared by calendar month, on a simple rule: on the 5th of each month, whole months older than two months back are deleted. At any given moment, what you can query is the current month plus the two preceding calendar months.
Cleanup date
Data removed
Queryable afterwards
5 August
All of May
June, July, August
5 September
All of June
July, August, September
5 October
All of July
August, September, October
Because cleanup works on whole months and runs on a fixed day, the usable window drifts between roughly two months and a few days and three months — shortest right after a cleanup, longest at the end of a month.
Cleanup only removes call-log detail; your account balance is unaffected. If you also need long-term records of top-ups and reconciliation, export and archive those as well.
Go to https://api.apiyi.com/log, or click Logs in the top navigation.
2
Filter first
Narrow by time range, model or status so you export only the records you actually want to archive.
3
Use async export
Click async export to start the job. It runs in the background, so large exports do not require you to sit on the page.
4
Download and archive
Download the file once the job finishes and store it in your own system or finance workflow.
Make monthly exports a habit: archive the previous month at the start of each month and the cleanup date stops mattering. This is especially worth doing for teams with reconciliation, expense-claim or audit requirements.
Two reasons: privacy minimization — the less retained, the smaller the exposure; and storage cost — log volume grows fast on a high-traffic platform, and keeping everything forever eventually shows up in pricing. We keep a window sufficient for reconciliation and give you the export tools to retain more yourself.
Can cleared logs be restored?
No. Cleanup is a physical delete with no recovery path, and support cannot restore it either. Export before the cleanup date.
Does cleanup affect my balance or top-up records?
No. Cleanup targets call-log detail; your account balance is unaffected. If you need long-term proof of top-ups and spending for expense claims or audits, export and keep those too.
What if the logs are not detailed enough for troubleshooting?
Within the retention window, the timestamp and model name from the log are enough to locate the vast majority of issues. If you genuinely need more detail, contact support and an administrator can temporarily enable detailed logging — see can I view detailed logs in the backend.
Does the exported file contain my inputs and outputs?
No. The export contains the log itself, with the same fields shown in the console — time, model, token counts, amount, status — and no prompt or model output whatsoever.
Can enterprise customers extend the retention period?
Enterprise customers with specific retention or compliance requirements can discuss it with our sales team. The standard recommendation is still regular exports — see enterprise vs individual users.