API de Descripción de Imágenes IA

Describir contenido de imágenes usando tecnología IA

La API de Descripción de Imágenes IA te permite usar tecnología IA avanzada para describir contenido de imágenes. Este endpoint procesa imágenes y devuelve descripciones textuales detalladas. Experimenta la potente función de descripción de imágenes IA de AI Describe Picture.

Endpoint

POST /api/api-call/describe-picture

Autenticación

Requiere una clave API válida en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY

Solicitud

Encabezados

Header	Required	Description
`Content-Type`	Yes	Debe ser `application/json`
`Authorization`	Yes	Tu clave API en formato `Bearer YOUR_API_KEY`

Parámetros del Cuerpo

Parameter	Type	Required	Description
`imageUrl`	string	Yes	URL de la imagen a describir (debe ser públicamente accesible)
`prompt`	string	No	Prompt personalizado (opcional)

Ejemplo de Solicitud

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "Describe en detalle todos los elementos, colores y composición en esta imagen"
}

Respuesta

Respuesta Exitosa (200)

La API devuelve un objeto JSON que contiene descripciones de imágenes con un array choices.

{
  "choices": [
    {
      "logprobs": null,
      "finish_reason": "stop",
      "native_finish_reason": "STOP",
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "La imagen retrata un primer plano de un zorro rojo mirando hacia la cámara. El zorro tiene pelaje esponjoso naranja y blanco, con orejas erguidas y ojos marrones brillantes. El fondo está desenfocado, posiblemente en un campo nevado o ambiente brillante.",
        "refusal": null,
        "reasoning": null
      }
    }
  ]
}

Descripción:

El array choices contiene contenido de descripción generado por IA, cada choice contiene un objeto de mensaje completo
El campo message.content contiene el texto de descripción de la imagen real
El formato de respuesta es compatible con la API de OpenAI

Respuestas de Error

400 Bad Request

{
  "message": "Invalid input"
}

401 Unauthorized

{
  "message": "Invalid or expired API key"
}

402 Payment Required

{
  "message": "Insufficient credits"
}

500 Internal Server Error

{
  "message": "Service error"
}

Límites de Uso

Consumo de créditos: 1 crédito por descripción
Requisitos de imagen: Soporta formatos JPG, PNG, WebP, máximo 5MB

Ejemplos de Uso

JavaScript/Node.js

async function describeImage(imageUrl, apiKey, prompt = null) {
  try {
    const response = await fetch('https://aidescribepicture.com/api/api-call/describe-picture', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl,
        prompt: prompt
      })
    });
 
    if (!response.ok) {
      const error = await response.text();
      throw new Error(`API Error: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // Extraer contenido de descripción
    const description = result.choices[0].message.content;
    return description;
  } catch (error) {
    console.error('Error describing image:', error);
    throw error;
  }
}
 
// Ejemplo de uso
const description = await describeImage(
  'https://example.com/image.jpg',
  'your-api-key-here',
  'Describe esta imagen en detalle'
);
console.log('Image description:', description);

cURL

curl -X POST https://aidescribepicture.com/api/api-call/describe-picture \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/image.jpg",
    "prompt": "Describe en detalle todos los elementos, colores y composición en esta imagen"
  }'