Image-to-image

What this lets you do

Transform one reference image through a durable managed turn.

What you need

A supported PNG, JPEG, or WebP file named reference.png
A server-side DreamLayer test or live key
One available live credit when using a live key
curl and jq

Steps

1. Upload one input

UPLOAD_RESPONSE=$(curl --silent --show-error https://api.dreamlayer.io/v1/input-assets \
  -H "Authorization: Bearer $DREAMLAYER_API_KEY" \
  -F "file=@reference.png")
INPUT_ASSET_ID=$(printf '%s' "$UPLOAD_RESPONSE" | jq -r '.input_asset_id')
export INPUT_ASSET_ID

The service accepts supported PNG, JPEG, or WebP input within the published byte, dimension, and pixel limits. It decodes, strips metadata, and stores a normalized owner-scoped PNG.

2. Save the returned `input_asset_id`

The commands above store the opaque input_asset_id in INPUT_ASSET_ID. Store it as application state and do not infer storage paths from it.

3. Execute

curl --no-buffer https://api.dreamlayer.io/v1/execute \
  -H "Authorization: Bearer $DREAMLAYER_API_KEY" \
  -H "DreamLayer-Version: 1" \
  -H "Idempotency-Key: greenhouse-edit-001" \
  -H "Accept: text/event-stream" \
  -H "Content-Type: application/json" \
  -d "{\"prompt\":\"Keep the structure and make the light warmer\",\"input_asset_id\":\"$INPUT_ASSET_ID\",\"aspect_ratio\":\"1:1\",\"max_credits\":1}"

V1 accepts one reference image. Unsupported, expired, or cross-account asset IDs fail closed. One completed image-to-image operation uses one live credit.

Confirm it worked

The stream emits one normalized PNG asset and ends with done status completed.

Common errors

413: resize or recompress an input outside the published limits.
404: upload a current asset owned by the authenticated account.
422: send exactly one supported reference image in V1.

Troubleshooting

Upload the input again if it expired. Do not reuse an asset ID from another account or ask the API to reveal its internal storage path.

Start

Build locally

DreamLayer Agent API

Orchestration

Project

Endpoint reference

Image-to-image

Image-to-image

What this lets you do

What you need

Steps

1. Upload one input

2. Save the returned `input_asset_id`

3. Execute

Confirm it worked

Common errors

Troubleshooting

Next steps

​Image-to-image

​What this lets you do

​What you need

​Steps

​1. Upload one input

​2. Save the returned input_asset_id

​3. Execute

​Confirm it worked

​Common errors

​Troubleshooting

​Next steps

Image-to-image

What this lets you do

What you need

Steps

1. Upload one input

2. Save the returned `input_asset_id`

3. Execute

Confirm it worked

Common errors

Troubleshooting

Next steps