quick_start
1
make_request
send_image_directly
2
get_description
receive_description
Base URL
https://api.describepic.com
api_endpoints
POST
/api/describe-image
describe_image
describe_image_desc
parameters
Name | Type | Required | Description |
---|---|---|---|
imageUrl | string | Required | Base64 encoded image data or image URL |
language | string | Optional | Output language: en, zh, es, fr, de, ja, ko (default: en) |
response_example
JSON
{
"description": "A serene mountain landscape with crystal-clear lake reflecting snow-capped peaks...",
"language": "en",
"model": "gpt-4.1-nano",
"timestamp": "2025-01-31T10:30:00.000Z"
}
GET
/api/languages
supported_languages
supported_languages_desc
response_example
JSON
{
"languages": [
{
"code": "en",
"name": "English",
"native": "English",
"flag": "🇺🇸"
},
{
"code": "zh",
"name": "Chinese",
"native": "中文",
"flag": "🇨🇳"
},
{
"code": "es",
"name": "Spanish",
"native": "Español",
"flag": "🇪🇸"
},
{
"code": "fr",
"name": "French",
"native": "Français",
"flag": "🇫🇷"
},
{
"code": "de",
"name": "German",
"native": "Deutsch",
"flag": "🇩🇪"
},
{
"code": "ja",
"name": "Japanese",
"native": "日本語",
"flag": "🇯🇵"
},
{
"code": "ko",
"name": "Korean",
"native": "한국어",
"flag": "🇰🇷"
}
]
}
code_examples
JavaScript
// JavaScript/Node.js Example - No API key required!
// Convert image to base64 first
const reader = new FileReader();
reader.onloadend = async () => {
const imageUrl = reader.result; // base64 data URL
const response = await fetch('https://describepic.com/api/describe-image', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
imageUrl: imageUrl,
language: 'en' // or 'zh', 'es', 'fr', 'de', 'ja', 'ko'
})
});
const result = await response.json();
console.log(result.description);
};
reader.readAsDataURL(imageFile);
Python
# Python Example - No authentication needed!
import requests
import base64
# Convert image to base64
with open("image.jpg", "rb") as image_file:
encoded_string = base64.b64encode(image_file.read()).decode()
image_url = f"data:image/jpeg;base64,{encoded_string}"
url = "https://describepic.com/api/describe-image"
payload = {
"imageUrl": image_url,
"language": "en" # or 'zh', 'es', 'fr', 'de', 'ja', 'ko'
}
response = requests.post(url, json=payload)
result = response.json()
print(result["description"])
cURL
# cURL Example - Simple and free!
# First convert your image to base64
IMAGE_BASE64=$(base64 -i image.jpg)
curl -X POST "https://describepic.com/api/describe-image" \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "data:image/jpeg;base64,'$IMAGE_BASE64'",
"language": "en"
}'
free_usage
- cost:100% Free
- daily_limit:Generous limits
- registration:Not required
simple_access
no_auth_description
// No authentication needed!
need_help
api_support_text