Vidéos

La génération vidéo est incluse dans la structure des documents à l'étranger afin de conserver une carte de produit cohérente, mais la disponibilité du point de terminaison public doit être confirmée à partir du schéma OpenAPI et de la configuration du compte à l'étranger.

Demande

Lorsque les points de terminaison vidéo sont activés, attendez-vous à un modèle de tâche asynchrone. Une demande de création comprend normalement une invite, un modèle, une durée, un rapport hauteur/largeur et une image ou un média de référence facultatif. Toutes les requêtes utilisent l'authentification du porteur :

Authorization: Bearer FISHAUDIO_API_KEY

Utilisez uniquement les chemins de point de terminaison renvoyés par GET /api/openapi.json. Ne copiez pas les chemins d’autres déploiements vers des clients étrangers.

Réponse

Les réponses aux tâches vidéo renvoient généralement d'abord un identifiant et un statut de tâche, puis une URL de vidéo de résultat une fois terminée. Stockez ensemble l’ID de la tâche et l’ID du projet d’origine, car la génération de vidéo peut survivre à une session de navigateur.

Facturation et crédits

Les tâches vidéo peuvent être coûteuses. Appliquez la confirmation de l'utilisateur pour une longue durée, une haute résolution ou une génération par lots. Vérifiez Profil avant de créer des lots et mettez votre file d'attente en pause en cas de crédits insuffisants.

Erreurs

Gérez les invites non valides, les modèles non pris en charge, les supports de référence inaccessibles, les crédits insuffisants et les échecs de traitement. Si le schéma n'expose pas les points de terminaison vidéo, affichez la fonctionnalité comme indisponible au lieu de tenter des routes masquées.

Endpoints publics actuels

Récupérez les modèles vérifiés avec GET /api/open/v1/media/models?mediaType=video, créez un job avec POST /api/open/v1/media/videos/jobs et consultez-le avec GET /api/open/v1/media/videos/jobs/{jobId}. La création exige un Idempotency-Key unique ; réutiliser la même clé renvoie la première réponse sans créer ni facturer un second job. Le quota API est utilisé, pas les crédits du site, et les échecs de création, de persistance, de traitement asynchrone ou d'expiration sont remboursés de manière idempotente.