Variate allows the user to regenerate the image, taking into consideration the elements of the initial output of the generations feature. This feature ensures continual refinement of the image, enhancing its alignment with the user's specifications.
Endpoint: https://api.vyro.ai/v1/imagine/api**/generations/variations**
Method: POST
Request Format: Requests must be sent as multipart/form-data to successfully send the image file along with the other data.
The API accepts the following parameters:
| Parameter | Type | Description | Default | Range / Values | Optional |
|---|---|---|---|---|---|
| prompt | String | The text that guides the image variation. | - | - | No |
| aspect_ratio | Integer | Determines the image style. | - | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 5:4, 4:5, 8:10, 3:1 |
Yes |
| image | Uploadfile | The base image that the variation will be based on. | - | - | No |
| seed | Integer | The seed value for the random number generator. | - | - | Yes |
| strength | float | Controls the variation from the base image. | 0.85 |
0-1 |
Yes |
| steps | Integer | The number of operations of the generator. | - | - | Yes |
| cfg | Float | Configures the generator's function. | 7.5 |
3-15 |
Yes |
| negative_prompt | String | Text that guides the generator away from specified results. | ' ' | - | Yes |
The endpoint responds with a variation of the base image. Each image style is represented by a unique enumerated value and ID.
The status code of the response can be:
| 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. |
| 401 | Unauthorised: Authentication is required or has failed. |
| 429 | Too Many Requests: The user has sent too many requests in a given amount of time. |
| 500 | Internal Server Error: An unexpected condition was encountered. |