# AI Image Generator
# Overview
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 https://yce.makeupar.com/ai-art-generator.
Use cases:
Sample output:
## File Specs & Errors
* Supported Formats & Dimensions
|AI Feature|Supported Dimensions|Supported File Size|Supported Formats|
| ---- | ---- | ---- | ---- |
| V1.0 Text to Image | Output: 1024 pixels on the long side. | Prompt cannot exceed 500 characters |jpg/jpeg/png/heic|
| V2.0 Text to Image | Output: The default resolution is 1664 × 928, with supported resolutions of 1664 × 928 (16:9), 1472 × 1104 (4:3), 1328 × 1328 (1:1), 1104 × 1472 (3:4), and 928 × 1664 (9:16). | Prompt cannot exceed 800 characters |jpg/jpeg/png/heic|
| V2.0 Image to Image | Input: Both the width and height must fall within the range of 384 to 3072 pixels.
Output: Customizable width and height range from 512 to 2,048 pixels, while the default configuration maintains a total pixel count of approximately 1,024 × 1,024 with an aspect ratio based on the input image. | <10MB
Prompt cannot exceed 800 characters |jpg/jpeg/png/heic/GIF
For animated GIFs, only the first frame is processed.|
* Error Codes
| Error Code | Description |
| ---------- | ----------- |
| exceed_max_filesize | The uploaded file size exceeds the maximum allowed limit. |
| invalid_parameter | One or more parameters are missing or invalid |
| error_download_image | Failed to download the source image. |
| error_decode_image | Failed to decode or parse the source image. |
| error_nsfw_content_detected | Not Safe For Work content was detected in the source image. |
| error_unsupport_ratio | The aspect ratio of the input image is not supported. |
| unknown_internal_error | An unspecified internal error occurred. |
License: Privacy policy
## Servers
```
https://yce-api-01.makeupar.com
```
## Security
### BearerAuthenticationV2
Use the standard 'Bearer authentication'. Put your 'API Key' in header: `Authorization:Bearer YOUR_API_KEY`. Notice that there is ' ' a space between 'Bearer' and the 'YOUR_API_KEY'.
Type: http
Scheme: bearer
## Download OpenAPI description
[AI Image Generator](https://docs.perfectcorp.com/_bundle/reference/ai_image_generator.yaml)
## V2.0
With the AI Image Generator V2.0 API, you can instantly generate high-quality images from text prompts or existing images with improved visual, detail, and consistency.
### Create a new file V2 for text to image.
- [POST /s2s/v2.0/file/text-to-image/youcam](https://docs.perfectcorp.com/reference/ai_image_generator/v2.0/paths/~1s2s~1v2.0~1file~1text-to-image~1youcam/post.md): To upload a new file, you'll first need to use the File API. It will give you a URL – use that URL to upload your file. Once the upload is finished, you can use the file_id from the same response to start using our AI features.
### Run an AI Image Generator task V2 for text to image.
- [POST /s2s/v2.0/task/text-to-image/youcam](https://docs.perfectcorp.com/reference/ai_image_generator/v2.0/paths/~1s2s~1v2.0~1task~1text-to-image~1youcam/post.md): AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.
If webhooks are not supported for the feature, or if your integration cannot use webhooks, implement polling. After starting an AI task, keep polling the task status endpoint at the given polling_interval until the task status is either success or error.
Do not stop polling a running task for longer than the allowed polling window. If the task is not polled in time, the task may expire; a later status check can return InvalidTaskId even if processing finished, and the consumed units may still be charged.
### Check the status of a AI Image Generator task V2 for text to image.
- [GET /s2s/v2.0/task/text-to-image/youcam/{task_id}](https://docs.perfectcorp.com/reference/ai_image_generator/v2.0/paths/~1s2s~1v2.0~1task~1text-to-image~1youcam~1%7Btask_id%7D/get.md)
### Create a new file V2 for image to image.
- [POST /s2s/v2.0/file/image-to-image/youcam](https://docs.perfectcorp.com/reference/ai_image_generator/v2.0/paths/~1s2s~1v2.0~1file~1image-to-image~1youcam/post.md): To upload a new file, you'll first need to use the File API. It will give you a URL – use that URL to upload your file. Once the upload is finished, you can use the file_id from the same response to start using our AI features.
### Run an AI Image Generator task V2 for image to image.
- [POST /s2s/v2.0/task/image-to-image/youcam](https://docs.perfectcorp.com/reference/ai_image_generator/v2.0/paths/~1s2s~1v2.0~1task~1image-to-image~1youcam/post.md): AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.
If webhooks are not supported for the feature, or if your integration cannot use webhooks, implement polling. After starting an AI task, keep polling the task status endpoint at the given polling_interval until the task status is either success or error.
Do not stop polling a running task for longer than the allowed polling window. If the task is not polled in time, the task may expire; a later status check can return InvalidTaskId even if processing finished, and the consumed units may still be charged.
### Check the status of a AI Image Generator task V2 for image to image.
- [GET /s2s/v2.0/task/image-to-image/youcam/{task_id}](https://docs.perfectcorp.com/reference/ai_image_generator/v2.0/paths/~1s2s~1v2.0~1task~1image-to-image~1youcam~1%7Btask_id%7D/get.md)
## V1.0
AI Image Generator API allows you to generate images from text prompts using predefined templates.
### List predefined templates.
- [GET /s2s/v2.0/task/template/text-to-image](https://docs.perfectcorp.com/reference/ai_image_generator/v1.0/paths/~1s2s~1v2.0~1task~1template~1text-to-image/get.md)
### Run an AI Image Generator task.
- [POST /s2s/v2.0/task/text-to-image](https://docs.perfectcorp.com/reference/ai_image_generator/v1.0/paths/~1s2s~1v2.0~1task~1text-to-image/post.md): AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.
If webhooks are not supported for the feature, or if your integration cannot use webhooks, implement polling. After starting an AI task, keep polling the task status endpoint at the given polling_interval until the task status is either success or error.
Do not stop polling a running task for longer than the allowed polling window. If the task is not polled in time, the task may expire; a later status check can return InvalidTaskId even if processing finished, and the consumed units may still be charged.
### Check a AI Image Generator task status.
- [GET /s2s/v2.0/task/text-to-image/{task_id}](https://docs.perfectcorp.com/reference/ai_image_generator/v1.0/paths/~1s2s~1v2.0~1task~1text-to-image~1%7Btask_id%7D/get.md)