Qwen Image 3.0 API: Guia de status e integração

Prepare o limite de integração

Mantenha IDs de modelo e custos de crédito na configuração do servidor. O navegador deve enviar um prompt e opções para seu próprio API em vez de expor uma chave de provedor.

• Autenticar cada solicitação de geração paga
• Valide o comprimento do prompt, o modelo e a proporção do lado do servidor
• Armazene as chaves do provedor fora do pacote do cliente
• Criação de limite de taxa e endpoints de pesquisa

Trate a geração como um trabalho assíncrono

Crie uma tarefa local, deduza os créditos atomicamente, envie ao provedor e depois pesquise até obter sucesso ou fracasso. As tarefas falhadas devem seguir uma política explícita de reversão de crédito.

• pendente → processamento → sucesso ou falha
• Persistir IDs de tarefa do provedor para recuperação
• Copie ativos finalizados para armazenamento de objetos duráveis
• Nunca confie em preços ou valores de crédito enviados pelo navegador

Use um ID de modelo Qwen Image 3 verificado

Um endpoint comercial verificado expõe o ID do modelo alibaba/qwen-image-3/text-to-image. A integração aceita prompts em chinês e inglês de até 800 caracteres, tamanhos de imagem suportados, expansão de prompt, verificação de segurança, sementes e formatos comuns de saída de imagem.

Persistir todas as imagens bem-sucedidas fora dos URLs temporários do provedor

Os URLs de saída do provedor podem expirar. Baixe arquivos bem-sucedidos no servidor, valide o tipo e tamanho do conteúdo, carregue-os para armazenamento de objetos privados e salve o URL durável com o registro da tarefa.

• Não exponha as chaves API do provedor no código do navegador
• Copie as saídas para R2 ou armazenamento S3 compatível
• Use URLs assinados para ativos de usuários privados
• Tentar novamente o armazenamento separadamente da geração do modelo

Opere a integração de produção com segurança

Mantenha o ID do modelo, a lista de permissões de entrada e o custo de crédito no servidor. Monitore falhas de envio, latência de fila, bloqueios de moderação, reembolsos e cópias de armazenamento, mantendo uma configuração 2.0 desativada para reversão de emergência.

Estime o custo de Qwen Image 3 API por ativo utilizável

A geração mais barata nem sempre é a entrega de menor custo. Estime o custo com base no preço do provedor, novas tentativas, falhas de moderação, armazenamento, largura de banda e a porcentagem de resultados aprovados na revisão. Acompanhe o custo por imagem aprovada para cada caso de uso, em vez de comparar apenas os preços principais do API.

• Registre a cobrança do provedor e o custo do crédito interno separadamente
• Avalie novas tentativas por produto, pôster ou ativo social aprovado
• Inclui armazenamento durável e largura de banda de download
• Defina alertas de orçamento antes de aumentar a simultaneidade

Use uma lista de verificação de lançamento de produção

Antes de enviar o tráfego do cliente para uma integração Qwen Image 3 API, execute prompts fixos em todas as proporções e idiomas suportados. Verifique tempos limite, envios duplicados, reembolsos de tarefas com falha, respostas de moderação, URLs temporários e interrupções de provedores. Um pequeno conjunto de testes gravado evita regressões dispendiosas após uma atualização do provedor.

• Teste a idempotência para que novas tentativas não sobrecarreguem os usuários
• Latência de registro, ID de solicitação do provedor e código de erro normalizado
• Verifique a propriedade da saída e os termos de retenção do seu plano
• Mantenha um modelo de reversão documentado e uma mensagem de status