Create Photo Pilot artwork
POST/v1/artworks/photo-pilot
Generate artwork using image-to-image conversion.
Request
- application/json
Body
required
Default value: cat
Limited to 256 words; additional content will be truncated.
Limited to 64 words; additional content will be truncated.
Possible values: [1, 2, 3]
When image guidance is set to low size of image can be set as parameter otherwise the input image size is taken as reference
Possible values: [1, 2, 3, 4, 5]
Possible values: [1, 2, 3, 4, 5]
Possible values: [1, 2, 3, 4, 5]
Possible values: [1:1, 2:3, 3:4, 4:3, 9:16, 3:2, 16:9]
Has effect only if image Guidance is set to low. Can not be used at the same time with width and height provide only aspect ratio or image size.
Toggle high resolution size of supported aspect ratios
Possible values: >= 512 and <= 2048
Use aspectRatio instead of custom width and height for better quality. Only honored when imageGuidance is LOW; otherwise the source image's dimensions are used. When LOW, the total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216), or 1,763,584 pixels (e.g., 1328 × 1328) when highResolution is true.
Possible values: >= 512 and <= 2048
Use aspectRatio instead of custom width and height for better quality. Only honored when imageGuidance is LOW; otherwise the source image's dimensions are used. When LOW, the total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216), or 1,763,584 pixels (e.g., 1328 × 1328) when highResolution is true.
Source image URL for img2img.
Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.
Responses
- 202
- 400
- 401
- 403
- 429
- 500
Response indicating that the artwork was successfully created.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [photo_pilot]
parameters
object
required
Default value: cat
Limited to 256 words; additional content will be truncated.
Limited to 64 words; additional content will be truncated.
Possible values: [1, 2, 3]
When image guidance is set to low size of image can be set as parameter otherwise the input image size is taken as reference
Possible values: [1, 2, 3, 4, 5]
Possible values: [1, 2, 3, 4, 5]
Possible values: [1, 2, 3, 4, 5]
Possible values: [1:1, 2:3, 3:4, 4:3, 9:16, 3:2, 16:9]
Has effect only if image Guidance is set to low. Can not be used at the same time with width and height provide only aspect ratio or image size.
Toggle high resolution size of supported aspect ratios
Possible values: >= 512 and <= 2048
Use aspectRatio instead of custom width and height for better quality. Only honored when imageGuidance is LOW; otherwise the source image's dimensions are used. When LOW, the total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216), or 1,763,584 pixels (e.g., 1328 × 1328) when highResolution is true.
Possible values: >= 512 and <= 2048
Use aspectRatio instead of custom width and height for better quality. Only honored when imageGuidance is LOW; otherwise the source image's dimensions are used. When LOW, the total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216), or 1,763,584 pixels (e.g., 1328 × 1328) when highResolution is true.
Possible values: >= 1, <= 3
Source image URLs for img2img. 1-3 entries; the first image's dimensions are used when imageGuidance is HIGH.
Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.
Possible values: [starting, processing, succeeded, failed, canceled]
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"artworkType": "photo_pilot",
"parameters": {
"prompt": "cat",
"negativePrompt": "string",
"imageGuidance": 1,
"modification": 1,
"creativity": 1,
"effort": 1,
"aspectRatio": "1:1",
"highResolution": true,
"width": 1024,
"height": 1024,
"bucket": "string",
"imageUrls": [
"string"
],
"webhook": "string"
},
"duration": 0,
"results": [
"string"
],
"status": "starting",
"createdAt": "2024-07-29T15:51:28.071Z"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Too Many Requests
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}