Processo de Solicitação
Para usar a API SeeDream Tasks, você precisa primeiro ir à página de solicitação SeeDream Images Generation API para solicitar o serviço correspondente e, em seguida, copiar o ID da tarefa da API SeeDream Images Generation, como mostrado na imagem: Por fim, acesse a página da API Tasks SeeDream Tasks API para solicitar o serviço correspondente. Após entrar na página, clique no botão “Acquire”, como mostrado na imagem: Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando você a se registrar e fazer login. Após o registro e login, você será redirecionado automaticamente de volta para a página atual. Na primeira solicitação, haverá um crédito gratuito disponível, permitindo que você use essa API gratuitamente.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 SeeDream Images Generation API. Usaremos um exemplo de 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 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: Alguns exemplos de código são os seguintes: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. Diferente do anterior, é necessário selecionar a ação 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，批量任务的所有具体详情信息。它 é um array, cada elemento do array tem o mesmo formato do resultado de consulta de uma única tarefa acima.count，此处批量查询任务的个数。
CURL
错误处理
在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：400 token_mismatched：Requisição inválida, possivelmente devido a parâmetros ausentes ou inválidos.400 api_not_implemented：Requisiçã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 requisições, você excedeu o limite de taxa.500 api_error：Erro interno do servidor, algo deu errado no servidor.