【api-doc】AI Image Merger

Use the API to morph two different images into one image

API call cost

Each API call consumes 2 credits.

Request

  • Method: POST
  • URL:https://yimeta.ai/api/v1/image-merger-generator

Request Header

Parameter Type Description
authorization string

Request Body

Parameter Type Required Description
img_url string Required URL or file of the original image1
mergered_img_url string Required URL or file of the merged original image2
model string No (defalut: FiBell_v1.safetensors) The Stable Diffusion model used to generate the fusion image
prompt string No (defalut: 'masterpiece), best quality') Positive prompt words describing the fusion image.
negative_prompt string No (defalut: '(worst quality, low quality:1.4)') Negative prompt
strength int No (defalut: 1) The degree of modification to the original image by the generated content (0 means the original image is fully preserved; 1 means it is completely overwritten).
width int No (defalut: 768) Pixel value of the width of the generated blended image.
height int No (defalut: 1024) Pixel value of the height of the generated blended image.
steps int No (defalut: 20)
cfg int No (defalut: 7)
weight float No (defalut: 1) The weight ratio of the original image, with a value range between 0 and 1.
mergered_weight float No (defalut: 0.5) The weight ratio of the merged original image2, with a value range between 0 and 1.
{
    "img_url": "",
    "mergered_img_url": "",
    "model": "FiBell_v1.safetensors", // optional
    "prompt": "(masterpiece), best quality" // optional
    "negative_prompt": "(worst quality, low quality:1.4)", // optional
    "strength": 1.0, // optional
    "width": 768, // optional
    "height": 1048, // optional
    "seed": -1, // optional
    "steps": 20, // optional
    "cfg": 7, // optional
    "weight": 1.0, // optional
    "mergered_weight": 0.5, // optional
}

Respones

Response Body

Parameter Type Description
status string API task status
task_id string The unique ID of the task.
result list result image

Example

####successed
{
  "stauts": "successed",
  "task_id": "f12400e2-5546-4286-92e9-2263d2f5c3fd",
  "result": ["https://art-global.yimeta.ai/workflow/aa4a777e2644f16372fd0cf4b5baffcb.webp"]
}

####over time
{
  "status": "executing",
  "task_id": "f12400e2-5546-4286-92e9-2263d2f5c3fd"
}

####failed
{
  "status": "failed",
  "error": "error message"
}

© Yimeta 2025, All rights reserved.