Overview

Welcome to the Cloudinary integration guide for Julep! This integration allows you to manage and transform media files efficiently, enabling you to build workflows that require robust media processing capabilities. Whether you’re uploading images or editing videos, this guide will walk you through the setup and usage.

Prerequisites

To use the Cloudinary integration, you need an API key, API secret, and cloud name. You can obtain these by signing up at Cloudinary.

How to Use the Integration

To get started with the Cloudinary integration, follow these steps to configure and create a task:

1

Configure Your API Key

Add your API key, API secret, and cloud name to the tools section of your task. This will allow Julep to authenticate requests to Cloudinary on your behalf.

2

Create Task Definition

Use the following YAML configuration to define your media processing task:

Cloudinary Example
name: Cloudinary Task
tools:
  - name: cloudinary_tool
    type: integration
    integration:
      provider: cloudinary
      method: media_upload
      setup:
        cloudinary_cloud_name: {cloudinary_cloud_name}
        cloudinary_api_key: {cloudinary_api_key}
        cloudinary_api_secret: {cloudinary_api_secret}
        params: # Optional setup parameters
          key1: value1 # these are placeholders for the actual parameters
          key2: value2 # these are placeholders for the actual parameters
main:
  - tool: cloudinary_tool
    arguments:
      file: "https://example.com/image.jpg"
      public_id: "my_image"
      upload_params: # Optional upload parameters
        param1: value1 # these are placeholders for the actual parameters
        param2: value2 # these are placeholders for the actual parameters
      return_base64: false

YAML Explanation

Remember to replace {cloudinary_cloud_name}, {cloudinary_api_key}, and {cloudinary_api_secret} with your actual credentials.

The different parameters available for the Cloudinary integration can be found in the Cloudinary API documentation.

Conclusion

With the Cloudinary integration, you can efficiently manage and transform media files. This integration provides a robust solution for media processing, enhancing your workflow’s capabilities and user experience.

For more information, please refer to the Cloudinary documentation.