Configure Clipdrop for PagibleAI

Clipdrop handles four PagibleAI image actions: erase, background removal, uncrop and upscale. Gemini still handles image generation, inpainting and repainting. See Configure PagibleAI CMS for the full provider map.

Check API compatibility

PagibleAI calls the legacy https://clipdrop-api.co endpoints. New Clipdrop image API customers are directed to Jasper, which uses a different API. A Jasper token will not work as a Clipdrop key.

Check the current Clipdrop API documentation and Jasper image API requirements before requesting access.

Get a compatible API key

If you already have a Clipdrop key, check it on the Clipdrop API account page. For new access, ask the provider whether the issued key works with clipdrop-api.co.

Store the key in your deployment secret manager. Do not put it in CMS content, logs, support tickets or source control.

Add the key to PagibleAI

Map the key only to the actions you use. The variable names come from the current PagibleAI AI configuration:

CLIPDROP_API_KEY="..."

CMS_AI_ERASE_API_KEY="${CLIPDROP_API_KEY}"
CMS_AI_ISOLATE_API_KEY="${CLIPDROP_API_KEY}"
CMS_AI_UNCROP_API_KEY="${CLIPDROP_API_KEY}"
CMS_AI_UPSCALE_API_KEY="${CLIPDROP_API_KEY}"

Run the command below after editing .env, then restart Octane, queue workers and other long-running PHP processes.

php artisan config:clear

Available actions

PagibleAI action
Clipdrop operation
Environment variable
Erase selected objects
Cleanup
CMS_AI_ERASE_API_KEY
Remove a background
Remove Background
CMS_AI_ISOLATE_API_KEY
Extend image boundaries
Uncrop
CMS_AI_UNCROP_API_KEY
Increase image resolution
Image Upscaling
CMS_AI_UPSCALE_API_KEY

Test the image actions

Use a disposable image and test the actions you enabled:

  1. Erase a selected object.
  2. Remove the background.
  3. Extend one edge.
  4. Upscale the image.

Check each result before using the action on production media. Every request consumes provider credits.

Troubleshooting

Why does PagibleAI say “No API key” or return 401?

Check that each enabled CMS_AI_*_API_KEY variable points to the Clipdrop key. Clear the configuration cache and restart long-running PHP processes.

Why does a Jasper token fail?

PagibleAI calls clipdrop-api.co; Jasper has a separate image API. Ask for a Clipdrop-compatible key or choose another supported provider.

What do 402 and 429 mean?

A 402 response usually means the account has no credits left. A 429 response means the provider is rate-limiting requests.

What if the key was exposed?

Revoke or rotate it, deploy the replacement, clear the configuration cache and restart workers. Remove the old value from logs and source history.