Skip to content

For AI agents: every API docs page in one plain-text file is at /docs/llms-full.txt, and the documentation index is at /llms.txt. This page is available as Markdown at https://diffio.ai/docs/overview/concepts/shares.md, and every docs URL returns Markdown when requested with Accept: text/markdown.

Shares: public links to a result

A share gives a project a public id; GET /shares/{share_id} answers anyone holding it, with no API key.It plays one finished generation (the newest, or one you pin) and never the uploaded original. Revoke it to turn it off.

How it works

  1. not shared: a new project
  2. published: PUT …/share; the id stays the same when you publish again
  3. revoked: DELETE …/share; the id answers 404 share_not_found
  • from published: new version, a changed generation_id or preview_seconds: earlier URLs stop
A project's share. Deleting the project revokes it too.

Limits

LimitValue
Share id17 characters
preview_seconds4 to 3600, rounded up to whole 4 second segments
Old URLs after a revoke or changestop within about a minute
API keynot needed for GET /shares/{share_id}; any origin may call it
Filesthe shared generation's playback files; never original

Build with it

Report an issue with this page