Cloudinary API
Cloudinary DocsGet API keys
HomeAPI ReferenceSDKsContext Plugin
Tasks

Check the status and result of a generation task

GET
/v2/generate/{cloud_name}/tasks/{task_id}

Check on an image generation running in the background: whether it is pending, processing, completed or failed, and, once it has completed, the generated images with their URLs, size and format.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your Cloudinary product environment.

task_id*string

The ID of the generation task.

Match^[a-f0-9]{1,256}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/generate/demo/tasks/053f4bde4b933c8ecef23724ecde63b667c1ea21816d56c161c7ec1df6297da4b43109625650e9edf0f42152cc4cc32c8ad57824ac75ba8e05020f827c415559ac1248076a2d72c0a73af0479cca77eb"

A completed async task — the asset is fully populated (storage + media).

{  "data": {    "task_id": "053f4bde4b933c8ecef23724ecde63b667c1ea21816d56c161c7ec1df6297da4b43109625650e9edf0f42152cc4cc32c8ad57824ac75ba8e05020f827c415559ac1248076a2d72c0a73af0479cca77eb",    "status": "completed",    "result": {      "assets": [        {          "storage": {            "storage_type": "temporary",            "secure_url": "https://upload-global.cloudinary.com/v2/demo/uploads/a78a2e043c2da0b50a98961d60a8b05a/stream",            "expires_at": "2026-06-25T12:50:26Z"          },          "format": "png",          "width": 1024,          "height": 768,          "bytes": 2048576,          "model": {            "family": "flux",            "tier": "premium",            "id": "flux-2-pro"          },          "seed": 42,          "created_at": "2026-04-21T14:30:00Z"        }      ]    }  },  "request_id": "17c3b70c5096df0e77e838323abb7029"}

Edit or combine images with a text prompt POST

Edit, restyle or combine existing images with AI, guided by a text prompt: replace a background, add or remove objects, apply a style, make on-brand variants, keep a character or product consistent across scenes, virtual try-on, or extend an image. Pass up to 4 reference images, each a public HTTPS `url` or an `asset_id` from the user's Cloudinary account, and refer to them in the prompt as `[1]`, `[2]`, …. For a local file, upload it first and reference it by its `asset_id`. Leave out `model` and a strong default edit model is used; only edit-capable models are accepted. **Storage is optional.** Get the image at a temporary link without saving anything to your account, or keep it in your Media Library. **What you get back.** Each image comes with its URL, size, format and the model that made it, either in the response or, for longer jobs, from a background task you can check or be notified about. Each generation uses Image Generation credits.

List collections GET

Returns the collections the caller may read, most-recently-updated first by default (`updated_at desc`). Results are paginated: pass the returned `next_cursor` back to fetch the next page.