Provides YouCam API for AI image and video editing and generation.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Include your API key in the request header using Bearer Token.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
For the AI magic avatar tool, this app uses the technology of image-to-image. which means the avatar is generated based on your photo. Once the photos are selected by the users, the technology embedded in the app starts analyzing and learning the user's facial traits. For more avatar styles, please refer to Use cases: Suggestions for How to Shoot:
If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
For the AI magic avatar tool, this app uses the technology of image-to-image. which means the avatar is generated based on your photo. Once the photos are selected by the users, the technology embedded in the app starts analyzing and learning the user's facial traits. For more avatar styles, please refer to Use cases: Suggestions for How to Shoot:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"template_id",
"output_count",
"src_file_url"
],
"properties": {
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"output_count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"examples": [
20
],
"description": "The number of generated images. It must be between 1 to 200."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"template_id",
"output_count",
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"output_count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"examples": [
20
],
"description": "The number of generated images. It must be between 1 to 200."
}
}
}
]
}
},
"additionalProperties": false
}List predefined templates.If the user does not specify the number of images to generate, default output_count to 1.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Perfect AI Color Correction let you automatically adjust saturation, temperature, and hue of photos with ease. Adjust white balance to correct color temperature, enhance saturation and make it vibrant, correct exposure level to balance brightness, remove color casts or tints, improve skin tones for a nature-looking portrait, enhance shadow and highlight details, remove noise and improve clarity, or even apply creative color grading effects all in one touch. With AI Color Correction, you can instantly generate 4 different color graded versions of your photos, each with unique color tones ranging from warm to cool within seconds. Sample Before: After: Before: After
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Using AI Face Swap for hyper-realistic effect with multiple faces supported. Our face swap artificial intelligence supports swapping one or multiple faces. Either for creating funny pictures of faces, or need a professional tool, we've got you covered.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"face_mapping",
"src_file_url",
"ref_file_urls"
],
"properties": {
"face_mapping": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of reference image"
},
"position": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of face on the target image. The index is from faces of detection result."
}
}
},
"description": "The designated ref image id and face position information to be swapped for each detected face on target image.\n\nLogic Rules\n 1. Index Mapping: The `index` maps directly to the order of images provided in your reference list.\n 2. Skipping Swaps: To skip swapping a specific face detected in the source, set both `index` and `position` to `-1`.\n 3. Array Order: The order of objects in the array should match based on `position`.\n\n\nExample Use Case\n\nScenario:\n Reference List: 2 images provided (Image A, Image B).\n Source Image: Contains 3 faces detected (Face 0, Face 1, Face 2).\n\n\nGoal:\n Swap Face 0 (Source) with Image 1 (Reference).\n Skip swapping Face 1 (Source).\n Swap Face 2 (Source) with Image 0 (Reference).\n\n\nConfiguration:\n \"face_mapping\": [\n {\n \"index\": 1, // Use the second reference image\n \"position\": 0 // Apply to the first detected face in source\n },\n {\n \"index\": -1, // Skip swapping\n \"position\": -1 // Skip swapping\n },\n {\n \"index\": 0, // Use the first reference image\n \"position\": 2 // Apply to the third detected face in source\n }\n ]\n"
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
},
"ref_file_urls": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
}
},
{
"type": "object",
"required": [
"face_mapping",
"src_file_url",
"ref_file_ids"
],
"properties": {
"face_mapping": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of reference image"
},
"position": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of face on the target image. The index is from faces of detection result."
}
}
},
"description": "The designated ref image id and face position information to be swapped for each detected face on target image.\n\nLogic Rules\n 1. Index Mapping: The `index` maps directly to the order of images provided in your reference list.\n 2. Skipping Swaps: To skip swapping a specific face detected in the source, set both `index` and `position` to `-1`.\n 3. Array Order: The order of objects in the array should match based on `position`.\n\n\nExample Use Case\n\nScenario:\n Reference List: 2 images provided (Image A, Image B).\n Source Image: Contains 3 faces detected (Face 0, Face 1, Face 2).\n\n\nGoal:\n Swap Face 0 (Source) with Image 1 (Reference).\n Skip swapping Face 1 (Source).\n Swap Face 2 (Source) with Image 0 (Reference).\n\n\nConfiguration:\n \"face_mapping\": [\n {\n \"index\": 1, // Use the second reference image\n \"position\": 0 // Apply to the first detected face in source\n },\n {\n \"index\": -1, // Skip swapping\n \"position\": -1 // Skip swapping\n },\n {\n \"index\": 0, // Use the first reference image\n \"position\": 2 // Apply to the third detected face in source\n }\n ]\n"
},
"ref_file_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"face_mapping",
"src_file_id",
"ref_file_urls"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"face_mapping": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of reference image"
},
"position": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of face on the target image. The index is from faces of detection result."
}
}
},
"description": "The designated ref image id and face position information to be swapped for each detected face on target image.\n\nLogic Rules\n 1. Index Mapping: The `index` maps directly to the order of images provided in your reference list.\n 2. Skipping Swaps: To skip swapping a specific face detected in the source, set both `index` and `position` to `-1`.\n 3. Array Order: The order of objects in the array should match based on `position`.\n\n\nExample Use Case\n\nScenario:\n Reference List: 2 images provided (Image A, Image B).\n Source Image: Contains 3 faces detected (Face 0, Face 1, Face 2).\n\n\nGoal:\n Swap Face 0 (Source) with Image 1 (Reference).\n Skip swapping Face 1 (Source).\n Swap Face 2 (Source) with Image 0 (Reference).\n\n\nConfiguration:\n \"face_mapping\": [\n {\n \"index\": 1, // Use the second reference image\n \"position\": 0 // Apply to the first detected face in source\n },\n {\n \"index\": -1, // Skip swapping\n \"position\": -1 // Skip swapping\n },\n {\n \"index\": 0, // Use the first reference image\n \"position\": 2 // Apply to the third detected face in source\n }\n ]\n"
},
"ref_file_urls": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
}
},
{
"type": "object",
"required": [
"face_mapping",
"src_file_id",
"ref_file_ids"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"face_mapping": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of reference image"
},
"position": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The index of face on the target image. The index is from faces of detection result."
}
}
},
"description": "The designated ref image id and face position information to be swapped for each detected face on target image.\n\nLogic Rules\n 1. Index Mapping: The `index` maps directly to the order of images provided in your reference list.\n 2. Skipping Swaps: To skip swapping a specific face detected in the source, set both `index` and `position` to `-1`.\n 3. Array Order: The order of objects in the array should match based on `position`.\n\n\nExample Use Case\n\nScenario:\n Reference List: 2 images provided (Image A, Image B).\n Source Image: Contains 3 faces detected (Face 0, Face 1, Face 2).\n\n\nGoal:\n Swap Face 0 (Source) with Image 1 (Reference).\n Skip swapping Face 1 (Source).\n Swap Face 2 (Source) with Image 0 (Reference).\n\n\nConfiguration:\n \"face_mapping\": [\n {\n \"index\": 1, // Use the second reference image\n \"position\": 0 // Apply to the first detected face in source\n },\n {\n \"index\": -1, // Skip swapping\n \"position\": -1 // Skip swapping\n },\n {\n \"index\": 0, // Use the first reference image\n \"position\": 2 // Apply to the third detected face in source\n }\n ]\n"
},
"ref_file_ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
}
}
}
]
}
},
"additionalProperties": false
}Run an AI Face Swap face detection task.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Transform your photos into stunning professional headshots with our AI Headshot Generator. Elevate your headshots quickly and effectively using our powerful AI tools designed to deliver professional-quality results. * Variety of Styles: From polished LinkedIn headshots and professional business headshots to creative model headshots, our AI headshot generator helps you select the perfect look to suit your needs. * Professional Results: Leveraging AI to ensure your headshots look natural and flattering, making a strong impression on potential employers and clients. * Convenience: Generate multiple AI headshots anytime, anywhere, without the need for a photographer. Perfect for busy professionals. For more AI Headshot styles, please refer to Use cases: Suggestions for How to Shoot:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"template_id",
"output_count",
"src_file_url"
],
"properties": {
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"output_count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"examples": [
20
],
"description": "The number of generated images. It must be between 1 to 200."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"template_id",
"output_count",
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"output_count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"examples": [
20
],
"description": "The number of generated images. It must be between 1 to 200."
}
}
}
]
}
},
"additionalProperties": false
}List predefined templates.If the user does not specify the number of images to generate, default output_count to 1.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Experience vibrant AI Outpainting with our cutting-edge AI Image Extender. Seamlessly expand images in any ratio, bringing out your creativity with our advanced AI technology. Preserve the highest quality while expanding your photos without compromising on style or aesthetics. Instantly transform your photos with one-click automatic background enlargement thanks to our user-friendly AI tool. Thanks to our advanced context-aware technology, we ensure a seamless and captivating experience for every viewer. Whether you're aiming for Instagram glory or framing a digital masterpiece, select from a variety of sizes and ratios for that perfect fit. As you tweak and transform, our AI seamlessly weaves its magic, ensuring the expanded areas blend flawlessly with your original photo.The user must always provide the original source image dimensions (width and height) so that missing parameters can be derived safely within valid ranges. If any of the placement, cropping, or output parameters are not explicitly provided, the tool will automatically compute them using the following defaults: the output image size will be set to 1.5× the original source image dimensions; the source image will not be cropped (crop_input_x = 0, crop_input_y = 0, crop_input_width = source_width, crop_input_height = source_height); and the source image will be placed at the exact center of the output image by calculating input_x and input_y such that the source image is horizontally and vertically centered. The input_width and input_height will match the uncropped source image size, and all derived values will strictly ensure that input_x + input_width ≤ output_width and input_y + input_height ≤ output_height, with every parameter remaining within its documented numeric limits.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
Discover the power of AI with our innovative text-to-image generator! Transform your ideas into stunning visuals instantly, experiment with prompts, explore unique styles like cartoons, oil paintings, or sketches, and let your creativity shine through. Whether you're an artist, designer, or creative soul, our tool offers endless possibilities to bring your vision to life. Add images as references to inspire new artistic directions while letting AI refine them into entirely original masterpieces. Want more inspirations? Please refer to Use cases: Sample output:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"model",
"prompt",
"src_file_urls"
],
"properties": {
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"1024*1024"
],
"description": "Specifies the resolution of the output image in the width*height format, such as \"1024\\*1536\". <br>- The width and height must each be in the range of [512, 2048] pixels. <br>- By default, the total number of pixels is approximately 1024\\*1024, with an aspect ratio similar to the input image (or the last image in a multi-image request). <br>When you specify the size parameter, the system uses the width and height specified by size as the target and adjusts the width and height of the actual output image to the nearest multiple of 16. For example, if you specify 1033\\*1032, the output image dimensions are 1040\\*1024. <br>Recommended resolutions for common aspect ratios: <br>- 1:1: 1024\\*1024, 1536\\*1536 <br>- 2:3: 768\\*1152, 1024\\*1536 <br>- 3:2: 1152\\*768, 1536\\*1024 <br>- 3:4: 960\\*1280, 1080\\*1440 <br>- 4:3: 1280\\*960, 1440\\*1080 <br>- 9:16: 720\\*1280, 1080\\*1920 <br>- 16:9: 1280\\*720, 1920\\*1080 <br>- 21:9: 1344\\*576, 2048\\*872"
},
"model": {
"enum": [
"youcam-image-v2"
],
"type": "string",
"description": "Model name."
},
"prompt": {
"type": "string",
"examples": [
"Make the girl from Image 1 wear the black dress from Image 2 and sit in the pose from Image 3. Keep her clothing, hairstyle, and expression unchanged, and ensure the action is natural and smooth."
],
"maxLength": 800,
"minLength": 1,
"description": "The image editing instruction (positive prompt) that describes the elements and visual features you want in the generated image. <br>This parameter supports Chinese and English with a maximum length of 800 characters. Each Chinese character or English letter counts as one character."
},
"prompt_extend": {
"anyOf": [
{
"enum": [
true,
false
],
"type": "boolean"
},
{
"type": "null"
}
],
"default": true,
"examples": [
true
],
"description": "Enable smart prompt rewriting. The model optimizes the positive prompt. Does not affect the negative prompt."
},
"src_file_urls": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
[
"https://example.com/selfie.jpg",
"https://example.com/selfie.jpg",
"https://example.com/selfie.jpg"
]
],
"maxItems": 3,
"minItems": 1,
"description": "The file URLs from upload file API. Should provide either 'src_file_urls' or 'src_file_ids'."
},
"negative_prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions."
],
"description": "The negative prompt, describing content you do not want in the generated image. <br>This parameter supports Chinese and English with a maximum length of 500 characters. Each Chinese character or English letter counts as one character."
}
}
},
{
"type": "object",
"required": [
"model",
"prompt",
"src_file_ids"
],
"properties": {
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"1024*1024"
],
"description": "Specifies the resolution of the output image in the width*height format, such as \"1024\\*1536\". <br>- The width and height must each be in the range of [512, 2048] pixels. <br>- By default, the total number of pixels is approximately 1024\\*1024, with an aspect ratio similar to the input image (or the last image in a multi-image request). <br>When you specify the size parameter, the system uses the width and height specified by size as the target and adjusts the width and height of the actual output image to the nearest multiple of 16. For example, if you specify 1033\\*1032, the output image dimensions are 1040\\*1024. <br>Recommended resolutions for common aspect ratios: <br>- 1:1: 1024\\*1024, 1536\\*1536 <br>- 2:3: 768\\*1152, 1024\\*1536 <br>- 3:2: 1152\\*768, 1536\\*1024 <br>- 3:4: 960\\*1280, 1080\\*1440 <br>- 4:3: 1280\\*960, 1440\\*1080 <br>- 9:16: 720\\*1280, 1080\\*1920 <br>- 16:9: 1280\\*720, 1920\\*1080 <br>- 21:9: 1344\\*576, 2048\\*872"
},
"model": {
"enum": [
"youcam-image-v2"
],
"type": "string",
"description": "Model name."
},
"prompt": {
"type": "string",
"examples": [
"Make the girl from Image 1 wear the black dress from Image 2 and sit in the pose from Image 3. Keep her clothing, hairstyle, and expression unchanged, and ensure the action is natural and smooth."
],
"maxLength": 800,
"minLength": 1,
"description": "The image editing instruction (positive prompt) that describes the elements and visual features you want in the generated image. <br>This parameter supports Chinese and English with a maximum length of 800 characters. Each Chinese character or English letter counts as one character."
},
"src_file_ids": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
[
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE=",
"pkVzplMv8Y1QPgHbqtKfyJmg+xJDUbTP16YijZ3qARNf",
"B5LNohvvO+7d/78Ymuhp6vMiSooN/5DX9oVuupzkKctf"
]
],
"maxItems": 3,
"minItems": 1,
"description": "The file IDs from upload file API. Should provide either 'src_file_urls' or 'src_file_ids'."
},
"prompt_extend": {
"anyOf": [
{
"enum": [
true,
false
],
"type": "boolean"
},
{
"type": "null"
}
],
"default": true,
"examples": [
true
],
"description": "Enable smart prompt rewriting. The model optimizes the positive prompt. Does not affect the negative prompt."
},
"negative_prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions."
],
"description": "The negative prompt, describing content you do not want in the generated image. <br>This parameter supports Chinese and English with a maximum length of 500 characters. Each Chinese character or English letter counts as one character."
}
}
}
]
}
},
"additionalProperties": false
}Discover the power of AI with our innovative text-to-image generator! Transform your ideas into stunning visuals instantly, experiment with prompts, explore unique styles like cartoons, oil paintings, or sketches, and let your creativity shine through. Whether you're an artist, designer, or creative soul, our tool offers endless possibilities to bring your vision to life. Add images as references to inspire new artistic directions while letting AI refine them into entirely original masterpieces. Want more inspirations? Please refer to Use cases: Sample output:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | object |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"size": {
"anyOf": [
{
"enum": [
"1664*928",
"1472*1104",
"1328*1328",
"1104*1472",
"928*1664"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "1664*928",
"examples": [
"1664*928"
],
"description": "Output image resolution, formatted as width\\*height. <br> Supported resolutions and their aspect ratios: <br>- 1664\\*928 (default): 16:9 <br>- 1472\\*1104: 4:3 <br>- 1328\\*1328: 1:1 <br>- 1104\\*1472: 3:4 <br>- 928\\*1664: 9:16"
},
"model": {
"enum": [
"youcam-image-v2"
],
"type": "string",
"description": "Model name."
},
"prompt": {
"type": "string",
"examples": [
"A sitting orange cat with a joyful expression, lively and adorable, highly realistic."
],
"maxLength": 800,
"minLength": 1,
"description": "A positive prompt describing the image content, style, and composition you want. <br>Supports Chinese and English. Maximum length is 800 characters. Each Chinese character, letter, digit, or symbol counts as one character."
},
"prompt_extend": {
"anyOf": [
{
"enum": [
true,
false
],
"type": "boolean"
},
{
"type": "null"
}
],
"default": true,
"examples": [
true
],
"description": "Enable smart prompt rewriting. The model optimizes the positive prompt. Does not affect the negative prompt."
},
"negative_prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"Low resolution, low quality, distorted limbs, malformed fingers, oversaturated colors, wax-like appearance, no facial details, overly smooth surfaces, AI-generated look. Chaotic composition. Blurry or distorted text."
],
"description": "A negative prompt describing what you do not want in the image. <br>Supports Chinese and English. Maximum length is 500 characters."
}
}
}
},
"additionalProperties": false
}Remove unwanted objects with precision from your photos while preserving intricate details. To use this amazing feature, simply input a photo along with a grayscale mask where white pixels indicate foreground elements and black pixels represent background areas. The AI Object Removal then leverages advanced algorithms to produce natural-looking images by effectively removing unwanted objects such as people, reflections, shadows, and other distractions from your photos. Sample input: Sample output: Sample input: Sample output:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url",
"msk_file_url"
],
"properties": {
"msk_file_url": {
"type": "string",
"examples": [
"https://example.com/mask.jpg"
],
"description": "URL of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. The URL should be publicly accessible."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_url",
"msk_file_id"
],
"properties": {
"msk_file_id": {
"type": "string",
"examples": [
"eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw="
],
"description": "ID of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. File ID from upload file API."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id",
"msk_file_url"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"msk_file_url": {
"type": "string",
"examples": [
"https://example.com/mask.jpg"
],
"description": "URL of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. The URL should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id",
"msk_file_id"
],
"properties": {
"msk_file_id": {
"type": "string",
"examples": [
"eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw="
],
"description": "ID of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. File ID from upload file API."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}The bokeh effect is a popular photographic technique used to blur the background of a photo and bring the subject into focus. It adds an artistic touch to a photograph, making it look more professional and eye-catching. Create professional-looking photos with the AI Photo Background Blur API, which automatically isolates subjects and applies a natural background blur to draw attention where it matters most. **Sample Usage Scenarios:** * Portrait Enhancement Apply a natural bokeh effect to make subjects stand out and improve the visual quality of profile or portrait photos. Before: After: * Professional Headshots Create studio-like background blur effects from standard photos for business profiles and corporate directories. Before: After:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"intensity": {
"anyOf": [
{
"type": "integer",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
],
"default": 50,
"examples": [
50
],
"description": "The intensity of the background blur. 0 means no blur, and 100 means the maximum blur.\n"
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"intensity": {
"anyOf": [
{
"type": "integer",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
],
"default": 50,
"examples": [
50
],
"description": "The intensity of the background blur. 0 means no blur, and 100 means the maximum blur.\n"
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}The AI Photo Background Change API enhances images by isolating the subject from the original background, enabling a wide range of applications including product-focused use cases in business. This API enables developers to replace the background using custom prompts or predefined templates. **Sample Usage** Before: After: Before: After:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"type": {
"anyOf": [
{
"enum": [
"prompt",
"template"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "prompt",
"description": "How the background is generated. With `prompt` (the default), the background is generated from `prompt`. With `template`, the background is generated from the predefined template specified by `template_id`, and `prompt` is ignored."
},
"prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"A sunny beach with palm trees."
],
"description": "Prompt to generate image background."
},
"template_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"nature_cherryblossom"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"type": {
"anyOf": [
{
"enum": [
"prompt",
"template"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "prompt",
"description": "How the background is generated. With `prompt` (the default), the background is generated from `prompt`. With `template`, the background is generated from the predefined template specified by `template_id`, and `prompt` is ignored."
},
"prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"A sunny beach with palm trees."
],
"description": "Prompt to generate image background."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"template_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"nature_cherryblossom"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
}
}
}
]
}
},
"additionalProperties": false
}List predefined AI photo Background Change V2 templates.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Remove background from photo with impeccable accuracy, ensuring the high quality of images. * Automatic Background Detection: : Uses AI to identify and separate the subject from the background. * High Precision Editing: : Provides clean and precise edges around the subject. * Supports various categories: People, Products, Animals, Cars, Graphics & more. * Easy to chain with other AI tasks: The output file ID can be chained into other AI tasks in a flash.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Using the latest AI technology to colorize black and white photos, old images, or repair them. With AI Photo Colorize, you can instantly generate 4 different colorized versions of your photos, each with unique color tones ranging from warm to cool. Utilizing deep learning technology, this tool transforms your black and white photos into vibrant color images within seconds.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}AI Photo Enhance uses advanced AI and deep learning to analyze image details and improve resolution, making low-resolution images clear & fix motion blur. * No More Pixelation: Eliminate pixelation for smoother, more defined images. * Fix Blurry Photos: Remove blurriness to reveal sharper, crisper details. * Enhance Quality: Bring out finer details, making every part of your image stand out. * Sharpen Images: Increase sharpness for clearer and more vivid images. * Improve Clarity: Boost overall clarity to make your photos look fresh and professional. * Face Enhancement: Refine facial features for more lifelike, enhanced portraits in motional images. Before sample: After sample: Before sample: After sample:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"scale",
"src_file_url"
],
"properties": {
"scale": {
"enum": [
1,
2,
4
],
"type": "integer",
"examples": [
1
],
"description": "Scaling ratio. Available values are 1, 2, 4."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"scale",
"src_file_id"
],
"properties": {
"scale": {
"enum": [
1,
2,
4
],
"type": "integer",
"examples": [
1
],
"description": "Scaling ratio. Available values are 1, 2, 4."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Brighten your images with Our AI image brightening tool effortlessly. With the legendary AI technology, lighten up any image of your choice. Brighten your dark photos or images with our AI Photo Lighting tool, illuminating your memories in a flash. Before After Brighten low-light photos effortlessly using AI tool, bringing out stunning details and vibrant colors. Before After Brighten your product pictures with AI Lighting tool for a captivating and stunning presentation.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Replace unwanted elements with new objects using AI Replace. By using this API, you can instantly remove unwanted object from your photo and replace it with a new one just by using text. Eliminate anything from bags to cars and beyond. Sample: For content creators aiming to perfect their social media presence, AI Replace offers a hassle-free way to polish travel photos or promotional images. Remove and replace elements with ease, ensuring your content stands out. Create stunning room mockups with AI Replace by filling empty spaces with aesthetically pleasing furniture and objects, transforming the perception of any space.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"prompt",
"src_file_url",
"msk_file_url"
],
"properties": {
"prompt": {
"type": "string",
"examples": [
"a cute cat"
],
"description": "Prompt for generating objects in the masked area."
},
"msk_file_url": {
"type": "string",
"examples": [
"https://example.com/mask.jpg"
],
"description": "URL of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. The URL should be publicly accessible."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"prompt",
"src_file_url",
"msk_file_id"
],
"properties": {
"prompt": {
"type": "string",
"examples": [
"a cute cat"
],
"description": "Prompt for generating objects in the masked area."
},
"msk_file_id": {
"type": "string",
"examples": [
"eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw="
],
"description": "ID of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. File ID from upload file API."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"prompt",
"src_file_id",
"msk_file_url"
],
"properties": {
"prompt": {
"type": "string",
"examples": [
"a cute cat"
],
"description": "Prompt for generating objects in the masked area."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"msk_file_url": {
"type": "string",
"examples": [
"https://example.com/mask.jpg"
],
"description": "URL of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. The URL should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"prompt",
"src_file_id",
"msk_file_id"
],
"properties": {
"prompt": {
"type": "string",
"examples": [
"a cute cat"
],
"description": "Prompt for generating objects in the masked area."
},
"msk_file_id": {
"type": "string",
"examples": [
"eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw="
],
"description": "ID of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. File ID from upload file API."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Embrace the excellence of studio kike AI Portrait Generator. Transform your selfie into a studio-quality portrait in a flash. * Studio-Free Convenience: No need for a photographer or studio visits—create studio-quality artistic photos anytime, anywhere * Quick Photo Transformation: Fast processing for instant high-quality artistic photo results, ideal for quick updates * High-Quality Artistic Output: Delivers professional-standard artistic photos with clear details, perfect lighting, just like you've taken the photos in a studio Use cases: Suggestions for How to Shoot:If the user does not specify the number of images to generate, default output_count to 1.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"template_id",
"output_count",
"src_file_url"
],
"properties": {
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"output_count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"examples": [
20
],
"description": "The number of generated images. It must be between 1 to 200."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"template_id",
"output_count",
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"output_count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"examples": [
20
],
"description": "The number of generated images. It must be between 1 to 200."
}
}
}
]
}
},
"additionalProperties": false
}List predefined templates.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}**AI Video Background Replace** The AI Video Background Replace API enables you to seamlessly add any background you choose. You can select from a wide range of options, including scenic landscapes, custom images, or even lighthearted visuals, giving you complete creative control to design the ideal setting for your content. There is no need for a studio or green screen. You can easily replace video backgrounds to achieve a clean and professional look. Whether you want to introduce a new environment or remove unwanted distractions, this solution is ideal for producing engaging videos and tutorials without requiring expensive equipment.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url",
"ref_file_url"
],
"properties": {
"ref_file_url": {
"type": "string",
"examples": [
"https://example.com/reference.jpg"
],
"description": "Url of the reference file to run task. The url should be publicly accessible."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
},
"background_mode": {
"anyOf": [
{
"enum": [
"crop",
"stretch"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "crop",
"description": "How the background image (the ref file) is fit onto the source video. `crop` keeps the background's aspect ratio and crops it to fill; `stretch` scales the background to the source video's dimensions."
}
}
},
{
"type": "object",
"required": [
"src_file_url",
"ref_file_id"
],
"properties": {
"ref_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of the reference file to run task. File ID from upload file API."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
},
"background_mode": {
"anyOf": [
{
"enum": [
"crop",
"stretch"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "crop",
"description": "How the background image (the ref file) is fit onto the source video. `crop` keeps the background's aspect ratio and crops it to fill; `stretch` scales the background to the source video's dimensions."
}
}
},
{
"type": "object",
"required": [
"src_file_id",
"ref_file_url"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"ref_file_url": {
"type": "string",
"examples": [
"https://example.com/reference.jpg"
],
"description": "Url of the reference file to run task. The url should be publicly accessible."
},
"background_mode": {
"anyOf": [
{
"enum": [
"crop",
"stretch"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "crop",
"description": "How the background image (the ref file) is fit onto the source video. `crop` keeps the background's aspect ratio and crops it to fill; `stretch` scales the background to the source video's dimensions."
}
}
},
{
"type": "object",
"required": [
"src_file_id",
"ref_file_id"
],
"properties": {
"ref_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of the reference file to run task. File ID from upload file API."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"background_mode": {
"anyOf": [
{
"enum": [
"crop",
"stretch"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "crop",
"description": "How the background image (the ref file) is fit onto the source video. `crop` keeps the background's aspect ratio and crops it to fill; `stretch` scales the background to the source video's dimensions."
}
}
}
]
}
},
"additionalProperties": false
}The AI Video Enhance API enables developers to automatically improve video quality with minimal effort. It uses advanced AI processing to fix blur, adjust sharpness, optimize brightness, and upscale low resolution footage. With a simple API call, videos can be transformed from low-res footage and old videos into clean and clear HD quality. This solution is designed for fast integration and does not require prior experience in video editing or machine learning. It is ideal for applications that handle user generated content, media platforms, marketing tools, and content automation systems. **Core Capabilities** 1. Blur correction The API detects motion blur and soft details, then reconstructs sharper frames using AI enhancement models. 2. Sharpness optimization Edges and textures are enhanced to create a more defined and visually crisp video. 3. Brightness and exposure adjustment Lighting inconsistencies are automatically corrected to improve visibility and color balance. 4. AI upscaling Resolution is intelligently increased from lower quality formats such as 480p to HD quality while preserving details. 5. Quality boosting Noise reduction and artifact removal are applied to produce clean and professional results. Sample usage cases:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"dst_duration",
"src_file_url"
],
"properties": {
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"dst_duration",
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
}
}
}
]
}
},
"additionalProperties": false
}Video face swapping is an AI-powered process that uses YouCam’s AI Video Face Swap API to replace one person's face with another in a video. With advanced AI technology, the AI video face swap delivers remarkably realistic results. The facial expressions, lighting, and skin tones are finely tuned to ensure that the swapped faces blend seamlessly with the original footage. > **Note:** This API supports video with single face only. For customizable solution, please [contact us](mailto:[email protected]). Sample usage cases:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"dst_duration",
"src_file_url",
"ref_file_url"
],
"properties": {
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
},
"ref_file_url": {
"type": "string",
"examples": [
"https://example.com/reference.jpg"
],
"description": "Url of the reference file to run task. The url should be publicly accessible."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"dst_duration",
"src_file_url",
"ref_file_id"
],
"properties": {
"ref_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of the reference file to run task. File ID from upload file API."
},
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"dst_duration",
"src_file_id",
"ref_file_url"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
},
"ref_file_url": {
"type": "string",
"examples": [
"https://example.com/reference.jpg"
],
"description": "Url of the reference file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"dst_duration",
"src_file_id",
"ref_file_id"
],
"properties": {
"ref_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of the reference file to run task. File ID from upload file API."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
}
}
}
]
}
},
"additionalProperties": false
}YouCam AI Video Generator transforms text prompts and images into captivating videos with ease. Powered by advanced AI technology, it creates realistic motion effects that bring your ideas and photos to life. With a wide selection of professionally optimized templates, you can quickly turn still images into engaging, high quality video content. To create an AI video from an image, start with a photo that features a clean background and a clearly visible portrait. Simply upload your image and let YouCam AI Video Generator do the rest, transforming your text prompts and photo into a dynamic video in just moments. Use cases:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"resolution",
"dst_duration",
"src_file_url"
],
"properties": {
"model": {
"anyOf": [
{
"enum": [
"youcam-video-v2"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Model name."
},
"prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 1500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"その女性は微笑んで、カメラを見ています"
],
"description": "Can be in any language. Will be automatically enhanced and output as English using Gemini API. Short prompts are ideal."
},
"resolution": {
"enum": [
"480",
"720",
"1080"
],
"type": "string",
"examples": [
480
],
"description": "To select the output resolution used in inference."
},
"dst_duration": {
"enum": [
5,
10
],
"type": "integer",
"examples": [
5
],
"description": "To select the output duration used in inference."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
},
"negative_prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 1500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"worst quality, low quality, JPEG compression residue, ugly."
],
"description": "The negative prompt."
}
}
},
{
"type": "object",
"required": [
"resolution",
"dst_duration",
"src_file_id"
],
"properties": {
"model": {
"anyOf": [
{
"enum": [
"youcam-video-v2"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Model name."
},
"prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 1500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"その女性は微笑んで、カメラを見ています"
],
"description": "Can be in any language. Will be automatically enhanced and output as English using Gemini API. Short prompts are ideal."
},
"resolution": {
"enum": [
"480",
"720",
"1080"
],
"type": "string",
"examples": [
480
],
"description": "To select the output resolution used in inference."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"dst_duration": {
"enum": [
5,
10
],
"type": "integer",
"examples": [
5
],
"description": "To select the output duration used in inference."
},
"negative_prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 1500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"worst quality, low quality, JPEG compression residue, ugly."
],
"description": "The negative prompt."
}
}
}
]
}
},
"additionalProperties": false
}YouCam AI Video Generator transforms text prompts and images into captivating videos with ease. Powered by advanced AI technology, it creates realistic motion effects that bring your ideas and photos to life. With a wide selection of professionally optimized templates, you can quickly turn still images into engaging, high quality video content. To create an AI video from an image, start with a photo that features a clean background and a clearly visible portrait. Simply upload your image and let YouCam AI Video Generator do the rest, transforming your text prompts and photo into a dynamic video in just moments. Use cases:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | object |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"type": "object",
"required": [
"prompt",
"dst_duration"
],
"properties": {
"model": {
"anyOf": [
{
"enum": [
"youcam-video-v2"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "youcam-video-v2",
"description": "Model name."
},
"ratio": {
"anyOf": [
{
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "16:9",
"examples": [
"16:9"
],
"description": "Aspect ratio of the generated video.\n\nOutput video resolutions (width*height) for each aspect ratio appear in the table below.:\n\n| Resolution tier | Aspect ratio | Output video resolution (width*height) |\n|:---|:---|:---|\n| **720P** | 16:9 | 1280*720 |\n| **720P** | 9:16 | 720*1280 |\n| **720P** | 1:1 | 960*960 |\n| **720P** | 4:3 | 1104*832 |\n| **720P** | 3:4 | 832*1104 |\n| **1080P** | 16:9 | 1920*1080 |\n| **1080P** | 9:16 | 1080*1920 |\n| **1080P** | 1:1 | 1440*1440 |\n| **1080P** | 4:3 | 1648*1248 |\n| **1080P** | 3:4 | 1248*1648 |\n"
},
"prompt": {
"type": "string",
"examples": [
"A kitten running in the moonlight."
],
"maxLength": 5000,
"minLength": 1,
"description": "Text prompt describing the video content and visual style.\nSupports Chinese and English. Each character or letter counts as one.\n"
},
"resolution": {
"anyOf": [
{
"enum": [
"720P",
"1080P"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "1080P",
"examples": [
"1080P"
],
"description": "Resolution tier of the generated video, controlling clarity (total pixels)."
},
"dst_duration": {
"type": "integer",
"maximum": 15,
"minimum": 2,
"examples": [
5
],
"description": "Duration of the generated video (seconds)."
},
"prompt_extend": {
"anyOf": [
{
"enum": [
true,
false
],
"type": "boolean"
},
{
"type": "null"
}
],
"default": true,
"examples": [
true
],
"description": "Enable prompt rewriting. When enabled, a Large Language Model rewrites the input prompt intelligently. This improves results for short prompts but increases latency."
},
"negative_prompt": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
"low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions."
],
"description": "Negative prompt describing content to exclude from the video, constraining the output.\nSupports Chinese and English.\n"
}
}
}
},
"additionalProperties": false
}**AI Video Object Removal** The AI Video Object Removal API enables seamless removal of unwanted elements from video content. Whether dealing with crowded backgrounds filled with tourists, cluttered environments such as desks with tissues and bottles, or distracting reflections on glass surfaces, the API can precisely and reliably eliminate masked areas with high accuracy and consistency.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"frame_idx",
"src_file_url",
"msk_file_url"
],
"properties": {
"frame_idx": {
"type": "integer",
"examples": [
0
],
"description": "Frame index of the input video that the provided mask image corresponds to."
},
"msk_file_url": {
"type": "string",
"examples": [
"https://example.com/mask.jpg"
],
"description": "URL of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. The URL should be publicly accessible."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"frame_idx",
"src_file_url",
"msk_file_id"
],
"properties": {
"frame_idx": {
"type": "integer",
"examples": [
0
],
"description": "Frame index of the input video that the provided mask image corresponds to."
},
"msk_file_id": {
"type": "string",
"examples": [
"eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw="
],
"description": "ID of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. File ID from upload file API."
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"frame_idx",
"src_file_id",
"msk_file_url"
],
"properties": {
"frame_idx": {
"type": "integer",
"examples": [
0
],
"description": "Frame index of the input video that the provided mask image corresponds to."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"msk_file_url": {
"type": "string",
"examples": [
"https://example.com/mask.jpg"
],
"description": "URL of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. The URL should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"frame_idx",
"src_file_id",
"msk_file_id"
],
"properties": {
"frame_idx": {
"type": "integer",
"examples": [
0
],
"description": "Frame index of the input video that the provided mask image corresponds to."
},
"msk_file_id": {
"type": "string",
"examples": [
"eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw="
],
"description": "ID of the mask file. This should be a grey scale mask image with the exact same width and height with the input source file where white pixels indicate foreground and black pixels represent background. File ID from upload file API."
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Create unique videos with our AI Video Filters and Effects. Easily enhance each video with stunning AI styles. AI Video Filters with Instant Transformation. Experience a seamless transformation with AI video filters that apply stunning effects instantly. Choose from an array of unique styles, including pop art, retro, anime, and more, to add depth and creativity to every frame. Sample usage cases:
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"template_id",
"dst_duration",
"src_file_url"
],
"properties": {
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/cat_video.mp4"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"template_id",
"dst_duration",
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"template_id": {
"type": "string",
"examples": [
"good_template_001"
],
"description": "ID of the template. List predefined templates first, and use the id of a template."
},
"dst_duration": {
"type": "integer",
"description": "The length of video in seconds"
}
}
}
]
}
},
"additionalProperties": false
}List predefined templates.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}AI-Powered Watermark Removal Reliably detect and erase watermarks, logos, and other marks while preserving the image's original quality and details. > Use the tool responsibly to avoid unethical applications, such as removing watermarks for unauthorized commercial use. Respect the intended purpose of the image and adhere to fair use principles.
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| request* | any |
{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"src_file_url"
],
"properties": {
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
}
}
},
{
"type": "object",
"required": [
"src_file_id"
],
"properties": {
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
}
}
}
]
}
},
"additionalProperties": false
}Interactive drag-and-drop widget for uploading images (JPEG, PNG) or videos (MP4). Returns file IDs for YouCam AI tools (AI-Fabric, AI-Cloth, AI-Makeup-Vto, AI-Hairstyle-Generator, AI-Skin-Analysis, etc.). /n Use when the user wants to upload or select an image/video (e.g. upload, drag & drop, choose file, pick image/video), or before any AI-* tool requiring src_file_id or ref_file_id when no file ID or URL is available. /n Also use as the mandatory fallback whenever Get-Upload-API-Info cannot complete the upload for any reason (including network restrictions, host_not_allowed, or other failures). Uploads directly from the browser, bypassing sandbox egress restrictions.
| Argument | Type | Description |
|---|---|---|
| task_type | any | Pre-select a task type. If omitted, the user picks one from the dropdown. |
{
"type": "object",
"properties": {
"task_type": {
"anyOf": [
{
"enum": [
"AI-Bracelet-Virtual-Try-On",
"AI-Earrings-Virtual-Try-On",
"AI-Necklace-Virtual-Try-On",
"AI-Ring-Virtual-Try-On",
"AI-Watch-Virtual-Try-On",
"AI-Abs-Filter",
"AI-Aging-Simulation",
"AI-Avatar-Generator",
"AI-Nail-Transfer",
"AI-Smile",
"AI-Studio-Generator",
"AI-Bag-Virtual-Try-On",
"AI-Beard-Style-Generator",
"AI-Photo-Background-Blur",
"AI-Photo-Background-Change",
"AI-Video-Background-Replace",
"AI-Body-Reshape",
"AI-Breast-Augmentation-Simulator",
"AI-Clothes-Virtual-Try-On",
"AI-Photo-Colorize",
"AI-Color-Correction",
"AI-Photo-Enhance",
"AI-Eye-Color-Lens-Virtual-Try-On",
"AI-Fabric-Virtual-Try-On",
"AI-Face-Attributes-and-Ratio-Analyzer",
"AI-Face-Lift",
"AI-Face-Reshape",
"AI-Face-Swap",
"AI-Video-Face-Swap",
"AI-Fitzpatrick-Skin-Type-Analysis",
"AI-Object-Removal-Pro",
"AI-Bangs-Filter-Virtual-Try-On",
"AI-Hair-Color-Virtual-Try-On",
"AI-Wavy-Hair-Virtual-Try-On",
"AI-Hair-Density-Detection",
"AI-Hair-Extension-Virtual-Try-On",
"AI-Hair-Frizziness-Detection",
"AI-Hair-Length-Detection",
"AI-Hair-Style-Virtual-Try-On",
"AI-Hair-Type-Detection",
"AI-Hair-Volume-Virtual-Try-On",
"AI-Hat-Virtual-Try-On",
"AI-Headshot-Generator",
"AI-Image-Generator-Image-to-Image",
"AI-Video-Generator-Image-to-Video",
"AI-Photo-Lighting",
"AI-Look-Virtual-Try-On",
"AI-Makeup-Virtual-Try-On",
"AI-Makeup-Transfer",
"AI-Nail-Virtual-Try-On",
"AI-Video-Object-Removal",
"AI-Replace",
"AI-Image-Extender",
"AI-Scarf-Virtual-Try-On",
"AI-Shoes-Virtual-Try-On",
"AI-Skin-Analysis",
"AI-Skin-simulation",
"AI-Facial-Color-Tones-Analyzer",
"AI-Photo-Background-Removal",
"AI-Teeth-Whitening",
"AI-Image-Generator-Text-to-Image",
"AI-Video-Generator-Text-to-Video",
"AI-Video-Enhancer",
"AI-Video-Style-Transfer",
"AI-Watermark-Removal"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pre-select a task type. If omitted, the user picks one from the dropdown."
}
},
"additionalProperties": false
}Check the unit consumption for each API. The values are consistent with those listed at https://yce.perfectcorp.com/ai-api/api-pricing.
| Argument | Type | Description |
|---|---|---|
| request* | object |
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"properties": {
"page_size": {
"anyOf": [
{
"type": "integer",
"maximum": 20,
"minimum": 1
},
{
"type": "null"
}
],
"default": null,
"examples": [
20
]
},
"starting_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"MjA"
]
}
}
}
},
"additionalProperties": false
}Retrieves the current status and results of a previously initiated AI processing task. Use this tool when you need to check on a task that was started earlier but hasn't completed yet, or when a user returns to inquire about a task they initiated previously. WHEN TO USE THIS TOOL: - When a user provides a task_id from a previous session and wants to check if their result is ready - When a user asks about a task they started earlier (e.g., 'Is my hairstyle ready?', 'Check my previous request') - When resuming a conversation where a task was left processing - When a task exceeded the initial polling timeout and the user wants to see if it has completed
| Argument | Type | Description |
|---|---|---|
| polling | boolean | If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish. |
| task_id* | string | ID of this task. |
| task_type* | string | The type of the task. |
| is_preprocess | boolean | Whether this is called from preprocess tool. |
{
"type": "object",
"required": [
"task_id",
"task_type"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"task_id": {
"type": "string",
"description": "ID of this task."
},
"task_type": {
"enum": [
"AI-Bracelet-Virtual-Try-On",
"AI-Earrings-Virtual-Try-On",
"AI-Necklace-Virtual-Try-On",
"AI-Ring-Virtual-Try-On",
"AI-Watch-Virtual-Try-On",
"AI-Abs-Filter",
"AI-Aging-Simulation",
"AI-Avatar-Generator",
"AI-Nail-Transfer",
"AI-Smile",
"AI-Studio-Generator",
"AI-Bag-Virtual-Try-On",
"AI-Beard-Style-Generator",
"AI-Photo-Background-Blur",
"AI-Photo-Background-Change",
"AI-Video-Background-Replace",
"AI-Body-Reshape",
"AI-Breast-Augmentation-Simulator",
"AI-Clothes-Virtual-Try-On",
"AI-Photo-Colorize",
"AI-Color-Correction",
"AI-Photo-Enhance",
"AI-Eye-Color-Lens-Virtual-Try-On",
"AI-Fabric-Virtual-Try-On",
"AI-Face-Attributes-and-Ratio-Analyzer",
"AI-Face-Lift",
"AI-Face-Reshape",
"AI-Face-Swap",
"AI-Video-Face-Swap",
"AI-Fitzpatrick-Skin-Type-Analysis",
"AI-Object-Removal-Pro",
"AI-Bangs-Filter-Virtual-Try-On",
"AI-Hair-Color-Virtual-Try-On",
"AI-Wavy-Hair-Virtual-Try-On",
"AI-Hair-Density-Detection",
"AI-Hair-Extension-Virtual-Try-On",
"AI-Hair-Frizziness-Detection",
"AI-Hair-Length-Detection",
"AI-Hair-Style-Virtual-Try-On",
"AI-Hair-Type-Detection",
"AI-Hair-Volume-Virtual-Try-On",
"AI-Hat-Virtual-Try-On",
"AI-Headshot-Generator",
"AI-Image-Generator-Image-to-Image",
"AI-Video-Generator-Image-to-Video",
"AI-Photo-Lighting",
"AI-Look-Virtual-Try-On",
"AI-Makeup-Virtual-Try-On",
"AI-Makeup-Transfer",
"AI-Nail-Virtual-Try-On",
"AI-Video-Object-Removal",
"AI-Replace",
"AI-Image-Extender",
"AI-Scarf-Virtual-Try-On",
"AI-Shoes-Virtual-Try-On",
"AI-Skin-Analysis",
"AI-Skin-simulation",
"AI-Facial-Color-Tones-Analyzer",
"AI-Photo-Background-Removal",
"AI-Teeth-Whitening",
"AI-Image-Generator-Text-to-Image",
"AI-Video-Generator-Text-to-Video",
"AI-Video-Enhancer",
"AI-Video-Style-Transfer",
"AI-Watermark-Removal"
],
"type": "string",
"description": "The type of the task."
},
"is_preprocess": {
"type": "boolean",
"default": false,
"description": "Whether this is called from preprocess tool."
}
},
"additionalProperties": false
}View the unit usage history for this account, such as units consumed or granted per task/order.
| Argument | Type | Description |
|---|---|---|
| request* | object |
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"properties": {
"page_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"examples": [
20
]
},
"starting_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"73a3c9e69b89"
]
}
}
}
},
"additionalProperties": false
}Get the current unit balance for this account, including each unit's type, amount, and expiry.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Returns the upload API endpoint and example request/response for uploading images (JPEG, PNG) or videos (MP4) to YouCam AI./n Use when the user wants to upload an image/video via the API. If upload cannot be completed for any reason (including network restrictions, host_not_allowed, or other errors), do not retry. Immediately use the File Upload Widget instead. Do not ask the user for a public URL.
| Argument | Type | Description |
|---|---|---|
| task_type* | string | The type of the AI task to upload file for. |
{
"type": "object",
"required": [
"task_type"
],
"properties": {
"task_type": {
"enum": [
"AI-Bracelet-Virtual-Try-On",
"AI-Earrings-Virtual-Try-On",
"AI-Necklace-Virtual-Try-On",
"AI-Ring-Virtual-Try-On",
"AI-Watch-Virtual-Try-On",
"AI-Abs-Filter",
"AI-Aging-Simulation",
"AI-Avatar-Generator",
"AI-Nail-Transfer",
"AI-Smile",
"AI-Studio-Generator",
"AI-Bag-Virtual-Try-On",
"AI-Beard-Style-Generator",
"AI-Photo-Background-Blur",
"AI-Photo-Background-Change",
"AI-Video-Background-Replace",
"AI-Body-Reshape",
"AI-Breast-Augmentation-Simulator",
"AI-Clothes-Virtual-Try-On",
"AI-Photo-Colorize",
"AI-Color-Correction",
"AI-Photo-Enhance",
"AI-Eye-Color-Lens-Virtual-Try-On",
"AI-Fabric-Virtual-Try-On",
"AI-Face-Attributes-and-Ratio-Analyzer",
"AI-Face-Lift",
"AI-Face-Reshape",
"AI-Face-Swap",
"AI-Video-Face-Swap",
"AI-Fitzpatrick-Skin-Type-Analysis",
"AI-Object-Removal-Pro",
"AI-Bangs-Filter-Virtual-Try-On",
"AI-Hair-Color-Virtual-Try-On",
"AI-Wavy-Hair-Virtual-Try-On",
"AI-Hair-Density-Detection",
"AI-Hair-Extension-Virtual-Try-On",
"AI-Hair-Frizziness-Detection",
"AI-Hair-Length-Detection",
"AI-Hair-Style-Virtual-Try-On",
"AI-Hair-Type-Detection",
"AI-Hair-Volume-Virtual-Try-On",
"AI-Hat-Virtual-Try-On",
"AI-Headshot-Generator",
"AI-Image-Generator-Image-to-Image",
"AI-Video-Generator-Image-to-Video",
"AI-Photo-Lighting",
"AI-Look-Virtual-Try-On",
"AI-Makeup-Virtual-Try-On",
"AI-Makeup-Transfer",
"AI-Nail-Virtual-Try-On",
"AI-Video-Object-Removal",
"AI-Replace",
"AI-Image-Extender",
"AI-Scarf-Virtual-Try-On",
"AI-Shoes-Virtual-Try-On",
"AI-Skin-Analysis",
"AI-Skin-simulation",
"AI-Facial-Color-Tones-Analyzer",
"AI-Photo-Background-Removal",
"AI-Teeth-Whitening",
"AI-Image-Generator-Text-to-Image",
"AI-Video-Generator-Text-to-Video",
"AI-Video-Enhancer",
"AI-Video-Style-Transfer",
"AI-Watermark-Removal"
],
"type": "string",
"description": "The type of the AI task to upload file for."
}
},
"additionalProperties": false
}Upload base64-encoded media files to the YouCam API and return file_id(s). If task_type is omitted, files are uploaded via the generic file API (POST /s2s/v2.0/file) rather than a task-specific upload path.
| Argument | Type | Description |
|---|---|---|
| files* | array | |
| task_type* | any |
{
"type": "object",
"required": [
"files",
"task_type"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"task_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"request"
],
"properties": {
"polling": {
"type": "boolean",
"default": true,
"description": "If true (default), keep polling until the task finishes, returning the final result. If false, return immediately without waiting for the task to finish."
},
"request": {
"anyOf": [
{
"type": "object",
"required": [
"output_width",
"output_height",
"input_x",
"input_y",
"input_width",
"input_height",
"crop_input_x",
"crop_input_y",
"crop_input_width",
"crop_input_height",
"src_file_url"
],
"properties": {
"input_x": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
240
],
"description": "Source image left position in output image, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"input_y": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
320
],
"description": "Source image top position in output image, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"input_width": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
480
],
"description": "Source image width, input_x + input_width must ⇐ output_width. value range: [1 - 4096]"
},
"crop_input_x": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
0
],
"description": "Crop source image from x, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"crop_input_y": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
0
],
"description": "Crop source image from y, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"input_height": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
640
],
"description": "Source image height, input_y + input_height must ⇐ output_height. value range: [1 - 4096]"
},
"output_width": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
960
],
"description": "Output image height. value range: [1 - 4096]"
},
"src_file_url": {
"type": "string",
"examples": [
"https://example.com/selfie.jpg"
],
"description": "Url of the file to run task. The url should be publicly accessible."
},
"output_height": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
1280
],
"description": "Output image width. value range: [1 - 4096]"
},
"crop_input_width": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
480
],
"description": "Crop source image with width crop_input_width. value range: [1 - 4096]"
},
"crop_input_height": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
640
],
"description": "Crop source image with height crop_input_height. value range: [1 - 4096]"
}
}
},
{
"type": "object",
"required": [
"output_width",
"output_height",
"input_x",
"input_y",
"input_width",
"input_height",
"crop_input_x",
"crop_input_y",
"crop_input_width",
"crop_input_height",
"src_file_id"
],
"properties": {
"input_x": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
240
],
"description": "Source image left position in output image, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"input_y": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
320
],
"description": "Source image top position in output image, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"input_width": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
480
],
"description": "Source image width, input_x + input_width must ⇐ output_width. value range: [1 - 4096]"
},
"src_file_id": {
"type": "string",
"examples": [
"pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE="
],
"description": "ID of file to run task. File ID from upload file API."
},
"crop_input_x": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
0
],
"description": "Crop source image from x, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"crop_input_y": {
"type": "integer",
"maximum": 4096,
"minimum": 0,
"examples": [
0
],
"description": "Crop source image from y, where The indices are ordered from top to bottom, and from left to right. value range: [0 - 4096]"
},
"input_height": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
640
],
"description": "Source image height, input_y + input_height must ⇐ output_height. value range: [1 - 4096]"
},
"output_width": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
960
],
"description": "Output image height. value range: [1 - 4096]"
},
"output_height": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
1280
],
"description": "Output image width. value range: [1 - 4096]"
},
"crop_input_width": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
480
],
"description": "Crop source image with width crop_input_width. value range: [1 - 4096]"
},
"crop_input_height": {
"type": "integer",
"maximum": 4096,
"minimum": 1,
"examples": [
640
],
"description": "Crop source image with height crop_input_height. value range: [1 - 4096]"
}
}
}
]
}
},
"additionalProperties": false
}