Llama Cloud Services SDK (Deprecated)

Warnings

• breaking The `llama-cloud-services` package is officially deprecated and will no longer be maintained after May 1, 2026. New features and bug fixes will only be released for the new `llama-cloud` package.
  Fix: Migrate to the new `llama-cloud` Python package by installing `pip install llama-cloud>=1.0` and updating your imports and code accordingly. Refer to the official LlamaIndex documentation for migration guides.
• gotcha When migrating to the new `llama-cloud` package, import paths and client initialization patterns have changed. Direct replacements of `LlamaParse`, `LlamaExtract`, and `LlamaCloudIndex` from `llama_cloud_services` will not work.
  Fix: For the new `llama-cloud` package, imports are generally from `llama_cloud` (e.g., `from llama_cloud import LlamaCloud`). Services are accessed via the main client object (e.g., `client.parsing.create(...)`). Review the `llama-cloud` documentation for the updated API.
• gotcha API keys are sensitive. Storing them directly in code is a security risk. The `api_key` parameter is mandatory for client initialization.
  Fix: Always retrieve your API key from environment variables (e.g., `os.environ.get('LLAMA_CLOUD_API_KEY')`) or a secure secrets management system. The `python-dotenv` package can also be used for local development.
• gotcha LlamaCloud services can be hosted in different regions (e.g., US and EU). The default base URL might not be suitable for all deployments.
  Fix: If you are using LlamaCloud services in the EU, you must specify `base_url=EU_BASE_URL` during client initialization (e.g., `LlamaParse(api_key=..., base_url=EU_BASE_URL)`). Ensure your API key is also created in the correct region.

Install

• pip install llama-cloud-services Install Deprecated Package
• pip install llama-cloud>=1.0 Install Recommended Replacement

Imports

• LlamaParse

  from llama_cloud_services import LlamaParse

• LlamaExtract

  from llama_cloud_services import LlamaExtract

• LlamaCloudIndex

  from llama_cloud_services import LlamaCloudIndex

• EU_BASE_URL

  from llama_cloud_services import EU_BASE_URL

  Used for connecting to EU SaaS endpoints.

Quickstart

This quickstart demonstrates how to initialize the LlamaParse client using the `llama-cloud-services` package. It uses an API key, preferably from an environment variable. Note that to actually parse a document, you would first need to upload a file to LlamaCloud and use its `file_id`.

import os
from llama_cloud_services import LlamaParse

# Get your API key from LlamaCloud. Recommended to use environment variables.
LLAMA_CLOUD_API_KEY = os.environ.get('LLAMA_CLOUD_API_KEY', 'your_api_key_here')

if LLAMA_CLOUD_API_KEY == 'your_api_key_here':
    print("WARNING: Please set the LLAMA_CLOUD_API_KEY environment variable or replace 'your_api_key_here' with your actual key.")

# Initialize LlamaParse
parser = LlamaParse(api_key=LLAMA_CLOUD_API_KEY)

# Example usage (assuming you have a file_id from an uploaded document)
# This is a conceptual example as parsing a file requires prior upload.
# For a full workflow, refer to the LlamaCloud documentation.
print("LlamaParse client initialized. You can now use it to parse documents.")
# To parse a document, you would typically upload a file first and then use its ID:
# job = parser.create(tier="agentic", version="latest", file_id="your_uploaded_file_id")
# print(f"Parsing job created with ID: {job.id}")