Processo de Solicitação
Para usar a API Flux Images Generation, primeiro acesse o console 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 logar. 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 estiver baixo, você pode recarregar o saldo geral no console.
📘 Documentação Completa: Flux Images Generation API →
Exemplo de Solicitação
A API Flux Tasks pode ser usada para consultar os resultados da API Flux Images Generation. Para saber como usar a API Flux Images Generation, consulte a documentação Flux Images Generation API. Usaremos um exemplo de ID de tarefa retornado pelo serviço da API Flux Images Generation. Suponha que temos um ID de tarefa: 2db0168c-2373-4367-8d9a-9dc778802e8a, 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.action: a forma de operação na 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, 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 de imagem. Por exemplo:id, o ID da tarefa de geração da imagem, usado para identificar exclusivamente esta tarefa de geração de imagem.request, informações da solicitação na tarefa de imagem.response, informações da resposta na tarefa de imagem.created_at, data e hora de criação da tarefa, timestamp Unix (segundos, ponto flutuante).started_at, data e hora em que a tarefa começou a ser executada, timestamp Unix (segundos, ponto flutuante).finished_at, data e hora em que a tarefa foi concluída, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado se a tarefa não estiver concluída.elapsed, tempo gasto na 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, diferentemente do anterior, onde a ação deve ser selecionada como retrieve_batch. Request Body inclui:ids: um array de IDs de tarefa enviados.action: a forma de operação na 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, como mostrado na imagem:
Exemplo de Resposta
Após uma solicitação bem-sucedida, a API retornará as informações detalhadas de todas as tarefas de imagem em lote. Por exemplo:CURL
Python
Erro de tratamento
Ao chamar a API, se encontrar um erro, a API retornará o respectivo código de erro e informação. 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.