Professional REST API for AI photo processing. Upload images, specify prompts — get direct links to results.
To get an API key and test endpoints, you need to sign in to the website.
Sign UpAll API requests must include an Authorization header with your API key:
Authorization: Bearer YOUR_API_KEYhttps://painty.cc/api/v1/photoUploads an image and text prompt, processes through AI model, returns direct links to results.
Content-Type: multipart/form-data
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Text description of changes (e.g., "Make the background clean and bright") |
image | file | Yes | Image file (formats: jpg, png, webp; max size: 10MB) |
Status: 200 OK
{
"status": "ok",
"data": {
"jobId": 123,
"originalUrl": "https://s3.twcstorage.ru/.../original.jpg",
"resultUrls": [
"https://s3.twcstorage.ru/.../result.jpg"
]
}
}| Code | Description | Solution |
|---|---|---|
400 | Bad Request | Check required parameters are present |
401 | Unauthorized | Check your API key is correct |
429 | Too Many Requests | Rate limit exceeded, please wait |
500 | Internal Server Error | Server error, retry later |
Maximum image upload size: 10 MB
Supported formats: JPG, PNG, WebP, GIF
Maximum processing time: 240 seconds
Processing results stored for: 24 hours
curl -X POST 'https://painty.cc/api/v1/photo' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-F "prompt=Make the background clean and bright" \
-F "image=@/path/to/photo.jpg"const formData = new FormData();
formData.append('prompt', 'Make the background clean and bright');
formData.append('image', fileInput.files[0]);
const response = await fetch('https://painty.cc/api/v1/photo', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
},
body: formData,
});
const data = await response.json();
console.log('Result:', data.data.resultUrls[0]);import requests
url = "https://painty.cc/api/v1/photo"
headers = {"Authorization": f"Bearer YOUR_API_KEY"}
files = {"image": open("photo.jpg", "rb")}
data = {"prompt": "Make the background clean and bright"}
response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()
print(result["data"]["resultUrls"][0])