Processo de Solicitação
Para usar a API Midjourney Imagine, primeiro acesse o Painel de Controle Ace Data Cloud para obter seu Token de API, que deve ser guardado para uso futuro.
Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde será convidado a se registrar e fazer login. Após a conclusão, você será redirecionado de volta para a página atual.
Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar um para cada serviço individualmente. A primeira solicitação oferece um crédito gratuito para que você possa experimentar; quando o crédito acabar, você pode recarregar o saldo geral no painel de controle.
📘 Documentação Completa: Midjourney Imagine API →
Exemplo de Solicitação
A API Midjourney Tasks pode ser usada para consultar os resultados da API Midjourney Imagine e da API Midjourney Describe. Para saber como usar a API Midjourney Imagine, consulte a documentação Midjourney Imagine API. Para saber como usar a Midjourney Describe, consulte Midjourney Describe API. Usaremos um exemplo de um ID de tarefa retornado pelo serviço Midjourney Imagine API. Suponha que temos um ID de tarefa: 7489df4c-ef03-4de0-b598-e9a590793434, a seguir, demonstraremos como passar um ID de tarefa.Exemplo de Tarefa
Configurando Cabeçalhos e Corpo da Solicitação
Request Headers incluem:accept: especifica que a resposta deve ser no formato JSON, preenchido comoapplication/json.authorization: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
id: o ID da tarefa enviada.ids: um array de IDs de tarefas para consulta em lote.action: a forma de operação na tarefa, suportandoretrieve(consulta única) eretrieve_batch(consulta em lote).
Exemplo de Código
Pode-se notar que, no lado direito da página, já foram gerados automaticamente códigos em várias linguagens, como mostrado na imagem:
CURL
Python
Exemplo de Resposta
Após uma solicitação bem-sucedida, a API retornará as informações detalhadas da tarefa da imagem aqui. Por exemplo:id, o ID da tarefa de geração da imagem, usado para identificar exclusivamente esta tarefa de geração de imagem.type, se type = imagine representa o resultado da API Midjourney Imagine, se type = describe representa o resultado da API Midjourney Describe.job_id, o ID da tarefa de consulta da imagem, usado para identificar exclusivamente esta tarefa de consulta da imagem.image_id, a identificação única da tarefa de imagem consultada, necessária para operações de transformação na imagem posteriormente.request, informações da solicitação na tarefa de consulta da imagem.response, informações da resposta na tarefa de consulta da imagem.created_at, data e hora de criação da tarefa, timestamp Unix (segundos, ponto flutuante).started_at, data e hora de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).finished_at, data e hora de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado se a tarefa não estiver concluída.elapsed, tempo de execução da tarefa, em segundos (ponto flutuante, com 3 casas decimais). Este campo não é retornado se a tarefa não estiver concluída.
Operação de Consulta em Lote
Esta operação é para consultar detalhes de tarefas de imagem para vários IDs de tarefa, diferindo do acima, onde a ação deve ser selecionada como retrieve_batch. Request Body inclui:ids: Array de IDs das tarefas enviadas.action: Modo de operação da tarefa.
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:
Exemplo de Resposta
Após uma solicitação bem-sucedida, a API retornará os detalhes específicos de todas as tarefas de imagem em lote. Por exemplo:items inclui os detalhes específicos das tarefas de imagem em lote, e as informações específicas de cada tarefa de imagem são as mesmas dos campos mencionados acima, com as seguintes informações de campo.
items, todos os detalhes específicos das tarefas de imagem em lote. É um array, onde cada elemento do array tem o mesmo formato do resultado de consulta de uma única tarefa mencionado acima.count, o número de tarefas de imagem consultadas em lote.
CURL
Python
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.