Images

Fuse multiple images (async, image-to-image)

Combine 2–10 images into a single cohesive image, guided by an optional prompt. Give the sources as library file_uuids or inline as base64 in images; exactly one of the two. Returns immediately with a job_id - poll GET /v1/jobs/{id} until status is completed. Discover valid model values via GET /v1/models (same set as variation).

post/v1/images/fuse

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/images/fuse
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Request body

file_uuidsstring[]

UUIDs of 2–10 source images already in your library. Use this or images.

imagesstring[]

2–10 source images inline, each base64 or a data URL (PNG, JPEG, WebP or GIF). Use this or file_uuids.

promptstring

Optional direction for how the images should be combined.

model'standard' | 'lite' | 'pro' | 'flux' | 'seedream' | 'seedream5'

Model to use for the fusion.

aspect_ratio'1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3'

Aspect ratio of the result.

Example request

{
  "prompt": "Place the character from the first image into the landscape of the second"
}

Response

Job queued

successboolean
timestampstring date-time

Example response

{
  "success": true,
  "data": {
    "status": "pending"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.