Combine

Combine merges 2–5 images into one output. A prompt describes how to arrange them.

depicta uvx depicta npx depicta

Usage

depicta combine image hero.png sidebar.png --prompt "Place hero on the left, sidebar on the right"

curl

curl -X POST https://api.depicta.ai/v1/combine/image \
  -H "Authorization: Bearer dpct_YOUR_API_KEY" \
  -F "images=@hero.png" \
  -F "images=@sidebar.png" \
  -F "prompt=Place hero on the left, sidebar on the right"

Python

response = httpx.post(
    "https://api.depicta.ai/v1/combine/image",
    headers={"Authorization": "Bearer dpct_YOUR_API_KEY"},
    files=[("images", open("hero.png", "rb")), ("images", open("sidebar.png", "rb"))],
    data={"prompt": "Place hero on the left, sidebar on the right"},
)

Content types

Like generate and edit, combine is type-specific:

Endpoint	Use for
POST /v1/combine/image	Photos, illustrations
POST /v1/combine/graphic	Icons, logos, UI elements
POST /v1/combine/diagram	Merge diagram sections

Reference images

Combine also supports up to 5 reference images to guide the composition style — for example, showing how elements should be arranged or what visual tone to aim for.

See Generate — Reference images for full details.

Limits

• Minimum: 2 images
• Maximum: 5 images
• Each image can be a file, URL, or stdin

Response

Same format as generate.