Image Remix, is an advanced feature of the Text-to-Image pipeline. It allows users to input a control image to guide the style of their prompts.
Endpoint: https://api.vyro.ai/v1/imagine/api/**edits/remix**
Request Format: The request must be sent as multipart/form data
to successfully send the image file along with the other data.
Requests must include the following parameters:
Parameter | Type | Description | Default | Range / Values | Optional |
---|---|---|---|---|---|
prompt |
String | The text guides the image generation. | - | - | No |
style_id |
Integer | Determines the image style. | 22 |
21, 22, 29 |
No |
image |
Upload file | The reference image for the output style. | - | jpeg/jpg, png | No |
seed |
Integer | The seed value for the random number generator. | - | - | Yes |
aspect_ratio |
String | The aspect ratio of the generated image. | '1:1' |
1:1, 9:16, 16:9, 4:3, 3:2 |
Yes |
strength |
Integer | Influences the impact of the control image on output. | 0 |
0-100 |
Yes |
control |
String | The method/control used to guide image generation. | 'openpose' | 'openpose', 'scribble', 'canny', 'lineart', 'depth' | Yes |
steps |
Integer | The generator's operation count. | - | 30-50 |
Yes |
cfg |
Float | Configures the generator's function. | 7.5 |
3-15 |
Yes |
negative_prompt |
String | Guides the generator away from specified results. | - | - | Yes |
The following keys and values must be included in the request headers:
The endpoint responds with an image/png.
Each image style is represented by a unique enumerated value and ID on the "Style ID: Enums(Image-Remix)" page.
Style IDs : Enums(Image-Remix)
The status code of the response is as follows:
Status Code | Reason |
---|---|
200 | Success: The request was successful, and the image was generated as expected. |
400 | Bad Request: The request is malformed or incomplete. Causes can include: missing image_file in the request, invalid input image format, or too large image resolution. |
401 | Unauthorized: Authentication is required or has failed. |
403 | Forbidden: The client does not have access rights to the content. |
404 | Style Control not found/loaded. |
500 | Internal Server Error: An unexpected condition was encountered, and no more specific message is suitable. |