Images

La génération d'images est représentée dans la navigation dans les documents afin que les documents étrangers conservent une carte de produits cohérente. La disponibilité des points de terminaison publics à l’étranger est basée sur un schéma. Vérifiez GET /api/openapi.json avant d’appeler les points de terminaison de l’image à partir du code de production.

Demande

Lorsque les points de terminaison de l'image sont activés, attendez-vous à un modèle de tâche asynchrone : créez une tâche avec une invite et des options de modèle, puis interrogez la fin. Les requêtes utilisent toujours l'authentification du porteur :

Authorization: Bearer FISHAUDIO_API_KEY

Ne déduisez pas les chemins d’outre-mer à partir d’autres documents. Utilisez uniquement les chemins présents dans le schéma OpenAPI outre-mer pour l'environnement déployé.

Réponse

Les réponses aux tâches d'image incluent généralement l'ID de la tâche, le statut, l'URL de l'image du résultat en cas de réussite et un code d'erreur en cas d'échec. Stockez l'ID de la tâche avant l'interrogation afin que les utilisateurs puissent récupérer le résultat après l'actualisation de la page ou le redémarrage du travailleur.

Facturation et crédits

La génération d'images peut être facturée en fonction du modèle, de la résolution, des images de référence ou de la tâche réussie. Validez la taille de l'invite et le support d'entrée avant de créer une tâche, et vérifiez Profil avant les lots volumineux.

Erreurs

Gérez séparément les modèles non pris en charge, les images de référence non valides, les crédits insuffisants et les échecs de traitement. Si les points de terminaison de l’image sont absents de GET /api/openapi.json, considérez la fonctionnalité comme non disponible publiquement pour le compte.

Points de terminaison OpenAPI canoniques

• Lister les modèles : GET /api/open/v1/media/models?mediaType=image
• Générer une image : POST /api/open/v1/media/images/jobs
• Consulter une tâche : GET /api/open/v1/media/images/jobs/{jobId}

Chaque requête de création doit inclure un en-tête Idempotency-Key unique. L’API utilise le quota API, et non les crédits de l’abonnement Web, et rembourse le quota de façon idempotente en cas d’échec du fournisseur, du stockage ou de la persistance.