Processo de Solicitação
Para usar a API SeeDream 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 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 estiver baixo, você pode recarregar o saldo geral no console.
📘 Documentação Completa: API SeeDream Images Generation →
Exemplo de Solicitação
A API SeeDream Tasks pode ser usada para consultar os resultados da API SeeDream Images Generation. Para saber como usar a API SeeDream Images Generation, consulte a documentação API SeeDream Images Generation. Usaremos um exemplo de um ID de tarefa retornado pelo serviço da API SeeDream Images Generation. Suponha que temos um ID de tarefa: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, a seguir, demonstraremos como passar um ID de tarefa.Exemplo de Tarefa
Configurando Cabeçalhos de Solicitação 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
Exemplo de Resposta
Após uma solicitação bem-sucedida, a API retornará as informações detalhadas da tarefa aqui. Por exemplo:success, o status da tarefa de geração de vídeo neste momento.task_id, o ID da tarefa de geração de vídeo neste momento.trace_id, o ID de rastreamento da geração de vídeo neste momento.data, a lista de resultados da tarefa de geração de imagem neste momento.image_url, o link da tarefa de geração de imagem neste momento.prompt, a palavra-chave.size: os pixels da imagem gerada.
Operação de Consulta em Lote
Esta operação é para consultar detalhes de várias IDs de tarefa, diferindo do acima, 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
Alguns exemplos de código são os seguintes:Exemplo de Resposta
Após uma solicitação bem-sucedida, a API retornará as informações detalhadas de todas as tarefas em lote desta vez. Por exemplo:items, todos os detalhes específicos da tarefa em lote. É um array, cada elemento do array tem o mesmo formato do resultado de consulta de uma única tarefa.count, o número de tarefas nesta consulta em lote.
created_at, hora de criação da tarefa, timestamp Unix (segundos, ponto flutuante).started_at, hora de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).finished_at, hora de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). O 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). O campo não é retornado se a tarefa não estiver concluída.
CURL
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.