Java 规范（Java Specification）通常指的是 Java 语言的语法规范和规范的行为，例如 Java 语言规范（The Java Language Specification）定义了 Java 语言的语法和语义规则，而 Java 虚拟机规范（The Java Virtual Machine Specification）定义了 Java 虚拟机的操作规则和指令集。
API 文档（Application Programming Interface Documentation）是指为特定的 API（如 Java 标准库、第三方库等）提供的文档，用于帮助开发人员了解如何正确地使用该 API。API 文档通常包含 API 的类、方法、参数、返回值等详细信息，用于开发人员在编程时参考和使用。在 Java 中，API 文档通常以 JavaDoc 格式编写，可以通过 JavaDoc 工具生成 HTML 格式的文档，方便开发人员查阅和使用。
因此，Java 规范是对 Java 语言和虚拟机的规范描述，而 API 文档是针对具体的 API（如 Java 标准库）提供的使用说明文档。它们之间的区别在于范围和内容的不同，但二者都对 Java 编程提供了重要的帮助和支持。