api_documentation

api_docs_subtitle

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

NameTypeRequiredDescription
imageUrlstringRequiredBase64 encoded image data or image URL
languagestringOptionalOutput 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