开发者与智能体资源
Ivy 发布的所有机器可读文档，集中在一处。无需密钥、无需注册、无需协商配额——下面每个端点都是公开的 GET。
Ivy 在设计上让软件能像人一样方便地使用它。站点提供公开接口的 OpenAPI 3.1 描述、面向回答引擎的 llms.txt 摘要、位于 /.well-known/ 下的发现文档，以及通过 Accept 头协商返回的每个营销页面的 text/markdown 版本。本页所列内容均稳定、带版本，可放心用于自动化。
API 规范
公开 API 的机器可读描述。两份文档由同一份源生成，因此永远不会不一致。
公开智能体 API
四个免鉴权的 JSON 端点，说明 Ivy 是什么、智能体在什么情况下应该调用它，以及从哪里下载。
回答引擎资源
遵循 llms.txt 约定、为大语言模型撰写的纯文本摘要。
发现文档
well-known URI，让客户端无需被告知资源位置即可自行完成配置。
Markdown 内容协商
向任意营销页面发送 Accept: text/markdown，即可得到整洁的 Markdown 而非 HTML——无需抓取，也无需解析 DOM。此做法遵循 acceptmarkdown.com 约定。
curl -H 'Accept: text/markdown' https://ivy.app/product速率限制
公开端点通过 IETF 草案标准的 RateLimit 响应头声明请求额度，客户端可以提前得知上限，而不是被切断后才发现。文档由缓存提供并每小时重新验证，因此遵守 Cache-Control 的客户端不会耗尽额度。一旦超出额度，响应为 429，并带上 Retry-After 头和符合 RFC 9457 的 problem 文档。
版本管理与弃用
智能体端点在路径中标注版本（/api/v1/）。破坏性变更以新版本发布，而不是修改现有版本。某个操作退役时，会先在 OpenAPI 文档中标记为 deprecated，并在移除前至少 180 天返回 Deprecation 与 Sunset 响应头，遵循 RFC 9745 与 RFC 8594。