SDK versions are pinned to specific API versions. When a new API version is released, a new version of the SDK is also released.The mappings between API versions and Java SDK versions are as follows:
API version
SDK version
2025-04 (latest)
v5.x
2025-01
v4.x
2024-10
v3.x
2024-07
v2.x
2024-04
v1.x
When a new stable API version is released, you should upgrade your SDK to the latest version to ensure compatibility with the latest API changes.
Alternatively, you can download the standalone uberjar pinecone-client-4.0.0-all.jar, which bundles the Pinecone SDK and all dependencies together. You can include this in your classpath like you do with any third-party JAR without having to obtain the pinecone-client dependencies separately.
Once installed, you can import the SDK and then use an API key to initialize a client instance:
Copy
import io.pinecone.clients.Pinecone;import org.openapitools.db_control.client.model.*;public class InitializeClientExample { public static void main(String[] args) { Pinecone pc = new Pinecone.Builder("YOUR_API_KEY").build(); }}