Qwen Image 3.0 API : Guide d'état et d'intégration

Préparer la limite d'intégration

Conservez les ID de modèle et les coûts de crédit dans la configuration côté serveur. Le navigateur doit soumettre une invite et des options à votre propre API plutôt que d'exposer une clé de fournisseur.

• Authentifier chaque demande de génération payante
• Valider la longueur de l'invite, le modèle et le rapport hauteur/largeur côté serveur
• Stocker les clés du fournisseur en dehors du bundle client
• Création de limites de débit et points de terminaison d'interrogation

Traitez la génération comme un travail asynchrone

Créez une tâche locale, déduisez les crédits de manière atomique, soumettez-la au fournisseur, puis interrogez jusqu'au succès ou à l'échec. Les tâches échouées doivent suivre une politique explicite d’annulation des crédits.

• en attente → traitement → succès ou échec
• Conserver les ID de tâche du fournisseur pour la récupération
• Copiez les ressources terminées vers un stockage d'objets durables
• Ne faites jamais confiance aux valeurs de prix ou de crédit envoyées par le navigateur

Utilisez un ID de modèle Qwen Image 3 vérifié

Un point de terminaison commercial vérifié expose l’ID du modèle alibaba/qwen-image-3/text-to-image. L'intégration accepte les invites en chinois et en anglais jusqu'à 800 caractères, les tailles d'image prises en charge, l'expansion des invites, les contrôles de sécurité, les graines et les formats de sortie d'image courants.

Conserver chaque image réussie en dehors des URL de fournisseur temporaires

Les URL de sortie du fournisseur peuvent expirer. Téléchargez les fichiers réussis sur le serveur, validez le type et la taille du contenu, téléchargez-les sur un stockage d'objets privé et enregistrez l'URL durable avec l'enregistrement de la tâche.

• Ne pas exposer les clés du fournisseur API dans le code du navigateur
• Copiez les sorties vers R2 ou un stockage S3 compatible
• Utiliser des URL signées pour les ressources d'utilisateurs privés
• Réessayez le stockage séparément de la génération de modèle

Opérer l’intégration de production en toute sécurité

Conservez l'ID du modèle, la liste d'autorisation d'entrée et le coût du crédit sur le serveur. Surveillez les échecs de soumission, la latence des files d'attente, les blocages de modération, les remboursements et les copies de stockage, tout en conservant une configuration 2.0 désactivée pour une restauration d'urgence.

Estimation du coût Qwen Image 3 API par actif utilisable

La génération la moins chère n’est pas toujours celle qui coûte le moins cher. Estimez le coût à partir du prix du fournisseur, des tentatives, des échecs de modération, du stockage, de la bande passante et du pourcentage de résultats qui réussissent l'examen. Suivez le coût par image approuvée pour chaque cas d'utilisation au lieu de comparer uniquement les prix principaux API.

• Enregistrer séparément les frais du fournisseur et le coût du crédit interne
• Mesurez les tentatives par produit, affiche ou actif social approuvé
• Inclure un stockage durable et une bande passante de téléchargement
• Définir des alertes budgétaires avant d'augmenter la simultanéité

Utiliser une liste de contrôle de lancement de production

Avant d'envoyer le trafic client vers une intégration Qwen Image 3 API, exécutez des invites fixes dans tous les ratios et langues pris en charge. Vérifiez les délais d'attente, les soumissions en double, les remboursements de tâches ayant échoué, les réponses de modération, les URL temporaires et les pannes de fournisseur. Une petite suite de tests enregistrée évite les régressions coûteuses après une mise à jour du fournisseur.

• Testez l'idempotence afin que les nouvelles tentatives ne facturent pas deux fois les utilisateurs.
• Latence du journal, ID de demande du fournisseur et code d'erreur normalisé
• Vérifiez la propriété des résultats et les conditions de conservation de votre plan
• Conserver un modèle de restauration et un message d'état documentés