Skip to main content
A principal função da API Midjourney Describe é obter descrições de imagens através do upload de fotos. Para usar essa API, basta fornecer o endereço do arquivo de imagem, e a API retornará uma descrição detalhada da imagem. Não é necessário configurar parâmetros complicados para obter descrições de alta qualidade. Suporta vários formatos de imagem: seja JPEG, PNG ou GIF, todos os formatos de imagem populares podem ser facilmente reconhecidos e processados. Este documento irá detalhar as instruções de integração da API Midjourney Describe, ajudando você a integrar e aproveitar ao máximo as poderosas funcionalidades dessa API. Com a API Midjourney Describe, você pode automatizar a descrição de imagens, aumentando a eficiência dos negócios.

Processo de Solicitação

Para usar a API Midjourney Describe, você precisa primeiro ir à página de solicitação Midjourney Describe API para solicitar o serviço correspondente. Ao entrar na página, clique no botão “Acquire”, conforme mostrado na imagem: Página de Solicitação Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após o login ou registro, você será redirecionado de volta para a página atual. Na primeira solicitação, haverá um crédito gratuito disponível, permitindo que você use a API sem custo.

Exemplo de Solicitação

Vamos usar uma imagem como exemplo para demonstrar como usar essa API. Suponha que temos uma imagem de paisagem, a seguir, demonstraremos como fazer o upload dessa imagem e obter a descrição.

Exemplo de Imagem de Solicitação

Imagem de Exemplo

Configurando o Cabeçalho e o Corpo da Solicitação

Request Headers incluem:
  • accept: especifica que a resposta deve ser no formato JSON, preenchido como application/json.
  • authorization: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
Request Body inclui:
  • image_url: o endereço do arquivo de imagem enviado.
Configuração conforme mostrado na imagem abaixo:

Exemplo de Código

Pode-se notar que, no lado direito da página, já foram gerados automaticamente códigos em várias linguagens, conforme mostrado na imagem:

Alguns exemplos de código são os seguintes:

CURL

Python

Exemplo de Resposta

Após uma solicitação bem-sucedida, a API retornará 4 descrições da imagem. Por exemplo:
Pode-se observar que o resultado contém um campo descriptions, que inclui quatro resultados, cada um sendo uma descrição candidata.

Tratamento de Erros

Ao chamar a API, se ocorrer um erro, a API retornará o código de erro e a mensagem correspondente. Por exemplo:
  • 400 token_mismatched: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 400 api_not_implemented: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 401 invalid_token: Não autorizado, token de autorização inválido ou ausente.
  • 429 too_many_requests: Muitas solicitações, você excedeu o limite de taxa.
  • 500 api_error: Erro interno do servidor, algo deu errado no servidor.

Exemplo de Resposta de Erro

Conclusão

Através deste documento, você já aprendeu como usar a API Midjourney Describe para descrever imagens. Esperamos que este documento ajude você a integrar e usar melhor essa API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico.