Documentação

API de Descrição de Imagem IA

Descrever conteúdo de imagem usando tecnologia IA

A API de Descrição de Imagem IA permite que você use tecnologia IA avançada para descrever conteúdo de imagem. Este endpoint processa imagens e retorna descrições textuais detalhadas. Experimente o poderoso recurso de descrição de imagem IA do AI Describe Picture.

Endpoint

POST /api/api-call/describe-picture

Autenticação

Requer uma chave API válida no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Requisição

Cabeçalhos

HeaderRequiredDescription
Content-TypeYesDeve ser application/json
AuthorizationYesSua chave API no formato Bearer YOUR_API_KEY

Parâmetros do Corpo

ParameterTypeRequiredDescription
imageUrlstringYesURL da imagem a ser descrita (deve ser publicamente acessível)
promptstringNoPrompt personalizado (opcional)

Exemplo de Requisição

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "Descreva em detalhes todos os elementos, cores e composição nesta imagem"
}

Resposta

Resposta de Sucesso (200)

A API retorna um objeto JSON contendo descrições de imagem com um array choices.

{
  "choices": [
    {
      "logprobs": null,
      "finish_reason": "stop",
      "native_finish_reason": "STOP",
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A imagem retrata um close de uma raposa vermelha olhando para a câmera. A raposa tem pelo fofo laranja e branco, com orelhas eretas e olhos castanhos brilhantes. O fundo está desfocado, possivelmente em um campo nevado ou ambiente brilhante.",
        "refusal": null,
        "reasoning": null
      }
    }
  ]
}

Descrição:

  • O array choices contém conteúdo de descrição gerado por IA, cada choice contém um objeto de mensagem completo
  • O campo message.content contém o texto de descrição da imagem real
  • O formato de resposta é compatível com a API OpenAI

Respostas de Erro

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"
}

Limites de Uso

  • Consumo de créditos: 1 crédito por descrição
  • Requisitos de imagem: Suporta formatos JPG, PNG, WebP, máximo 5MB

Exemplos 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();
    
    // Extrair conteúdo de descrição
    const description = result.choices[0].message.content;
    return description;
  } catch (error) {
    console.error('Error describing image:', error);
    throw error;
  }
}
 
// Exemplo de uso
const description = await describeImage(
  'https://example.com/image.jpg',
  'your-api-key-here',
  'Descreva esta imagem em detalhes'
);
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": "Descreva em detalhes todos os elementos, cores e composição nesta imagem"
  }'

Requisitos de Imagem

  • Formato: JPG, PNG, WebP
  • Tamanho: Máximo 5MB
  • Acessibilidade: A URL da imagem deve ser publicamente acessível
  • Conteúdo: Deve ser um arquivo de imagem válido

Tempo de Processamento

  • Típico: 10-30 segundos
  • Imagens grandes: Pode levar até 60 segundos

Créditos

  • Custo: 1 crédito por descrição
  • Dedução: Os créditos são deduzidos após processamento bem-sucedido

Melhores Práticas

  1. Qualidade da imagem: Use imagens de alta qualidade para melhores resultados
  2. Tratamento de erros: Sempre implemente tratamento de erro adequado
  3. Gerenciamento de créditos: Monitore regularmente seu saldo de créditos
  4. Prompts: Use prompts específicos para descrições mais precisas

Solução de Problemas

Problemas Comuns

401 Unauthorized

  • Verifique se sua chave API está correta
  • Certifique-se de que a chave API está ativa e não expirou

402 Payment Required

  • Adicione créditos à sua conta
  • Verifique seu saldo de créditos atual

400 Bad Request

  • Verifique se a imageUrl é uma URL válida e acessível
  • Certifique-se de que o formato da imagem é suportado

500 Internal Server Error

  • Erro interno do servidor, tente novamente mais tarde
  • Verifique se a URL da imagem está acessível

Suporte

Se você encontrar problemas não cobertos aqui, entre em contato com nossa equipe de suporte.