O que você vai criar
Você criará uma tarefa de geração de imagem Flux comPOST /flux/v1/flux-dev, consultará GET /flux/v1/get_result e fará o download da URL da imagem gerada quando a tarefa estiver pronta.
Pré-requisitos
- Uma chave de API da CometAPI armazenada em
COMETAPI_KEY - Python 3.10+ com
requests, ou Node.js 18+ - Um caminho de modelo Flux da referência da API Flux ou de Models
Chave de API, URL base, autenticação
A geração com Flux usa um nome de modelo no caminho da URL:Exemplos de código
Use as abas abaixo para exemplos copiáveis em cURL, Python e Node.js.Explicação do fluxo
A geração com Flux é assíncrona. O endpoint de criação retorna umid de tarefa. Faça polling em /flux/v1/get_result?id=<task_id> até que status seja Ready, depois baixe result.sample.
As URLs de resultado do Flux têm tempo limitado. Copie as imagens concluídas para o seu próprio armazenamento quando sua aplicação precisar de acesso durável.
Parâmetros comuns
Solução de problemas / FAQ
A tarefa permanece pendente
A tarefa permanece pendente
Continue fazendo polling com um loop de tentativas limitado e um timeout. Armazene o ID da tarefa para que o job possa ser verificado depois.
A URL da imagem expirou
A URL da imagem expirou
Baixe
result.sample logo após a tarefa ficar Ready, depois armazene a imagem no seu próprio armazenamento.Um parâmetro do Flux falha
Um parâmetro do Flux falha
O suporte a parâmetros do Flux varia conforme a variante do modelo. Comece com
prompt, width e height, depois consulte a referência da API do Flux antes de adicionar campos opcionais.Próximos passos
- Leia a referência da API de geração de imagem do Flux.
- Faça polling dos resultados com Obter resultado de imagem do Flux.
- Encontre modelos Flux em Models.
- Estime o custo com Estimar o custo da solicitação antes de chamar um modelo.