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
Autenticação
Requer uma chave API válida no cabeçalho Authorization:
Requisição
Cabeçalhos
Header | Required | Description |
---|---|---|
Content-Type | Yes | Deve ser application/json |
Authorization | Yes | Sua chave API no formato Bearer YOUR_API_KEY |
Parâmetros do Corpo
Parameter | Type | Required | Description |
---|---|---|---|
imageUrl | string | Yes | URL da imagem a ser descrita (deve ser publicamente acessível) |
prompt | string | No | Prompt personalizado (opcional) |
Exemplo de Requisição
Resposta
Resposta de Sucesso (200)
A API retorna um objeto JSON contendo descrições de imagem com um array choices.
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
401 Unauthorized
402 Payment Required
500 Internal Server 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
cURL
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
- Qualidade da imagem: Use imagens de alta qualidade para melhores resultados
- Tratamento de erros: Sempre implemente tratamento de erro adequado
- Gerenciamento de créditos: Monitore regularmente seu saldo de créditos
- 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.