Place de marché des modèles et facturation

La place de marché des modèles est le point d'entrée pour choisir un modèle et comprendre le prix des appels ; elle affiche le catalogue des modèles actuellement disponibles publiquement sur la plateforme. La portée réelle des appels reste déterminée par le groupe d'appel de l'API Key et l'état de disponibilité en temps réel.

Comment choisir un modèle

1. Recherchez par nom, ou filtrez par marque de modèle, capacité et type d'interface ;
2. Ouvrez les détails pour confirmer les interfaces prises en charge, les groupes disponibles et le type de tarification ;
3. Utilisez GET /v1/models pour confirmer l'ID de modèle visible pour cette clé ;
4. Utilisez l'ID de modèle renvoyé dans le backend métier pour lancer les requêtes.

Champs du catalogue de modèles

GET /v1/models renvoie les modèles appelables par la clé actuelle ; les champs sont décrits ci-dessous :

Le catalogue de modèles sert uniquement à confirmer « si cette clé peut appeler ce modèle » ; les limites de paramètres précises (nombre d'images de référence, spécifications de la vidéo d'entrée, durée et définition de sortie, etc.) sont déterminées par la page de détails du modèle et par les erreurs de paramètres renvoyées par l'interface. La plateforme ne devine pas les paramètres à la place du modèle et ne dégrade pas silencieusement les paramètres non pris en charge.

Comment lire les fiches de prix

L'affichage des prix sert à l'estimation ; le débit réel dépend de l'utilisation effective de la requête, du groupe auquel appartient la requête et des enregistrements de facturation côté serveur.

Modèles vidéo

Les séries doubao-seedance et seedance affichent une matrice de prix distincte, répartie selon « avec ou sans entrée vidéo » et « résolution de sortie » ; les cellules prises en charge indiquent le coût vidéo, et les combinaisons non prises en charge affichent clairement « non pris en charge ».

Pour lire la matrice, déterminez d'abord si une entrée vidéo est soumise cette fois, puis choisissez la résolution souhaitée. Par exemple, si vous ne téléchargez que du texte ou des images de référence, consultez la colonne « sans entrée vidéo » ; si vous soumettez une vidéo en entrée, consultez la colonne « avec entrée vidéo ». Ne déduisez pas les prix ou capacités non affichés à partir des niveaux voisins.

Avant l'appel, vérifiez :

• L'ID du modèle apparaît dans votre réponse /v1/models ;
• La requête utilise l'interface vidéo /v1/video/generations, et non l'interface texte ;
• Les images ou vidéos de référence respectent les exigences de paramètres publiques de ce modèle ;
• Le côté métier conserve et interroge l'ID de tâche renvoyé pour la tâche asynchrone.

Références de ressources et modèles

L'ajout d'une ressource est indépendant du modèle : une ressource ne doit être ajoutée qu'une seule fois, et la plateforme prépare la référence correspondante en fonction du modèle actuel. Un même ID de ressource peut être utilisé directement et repris d'un modèle à l'autre ; pour changer de modèle, il suffit de modifier le champ model de la requête.

Les modèles qui partagent la même bibliothèque de ressources, ainsi que les modèles prenant en charge les ressources de personnes réelles, sont indiqués dans l'interface de la bibliothèque de ressources.

Facturation et relevés

La place de marché des modèles affiche des indications de prix, qui ne correspondent pas au montant final du règlement. Les modèles texte sont généralement facturés selon l'usage réel d'entrée, de sortie et de cache ; les modèles d'image, d'audio ou de vidéo peuvent être facturés à l'unité, à la durée ou selon une unité de mesure définie par le modèle.

Les tâches asynchrones telles que la vidéo sont réglées à l'achèvement : une soumission réussie ne fait qu'accepter la tâche, sans pré-autorisation ; une fois la tâche terminée, une seule ligne de débit réel apparaît dans la facturation. Avant la soumission, la plateforme vérifie si le solde du compte (ou le quota de l'API Key actuelle) couvre l'estimation de cette opération ; en cas d'insuffisance, elle renvoie directement un message lisible et ne crée pas la tâche. Après l'achèvement, vous pouvez vérifier le modèle, l'heure, l'ID de requête et le débit réel dans le portefeuille ou les enregistrements d'usage.

Un échec de validation des paramètres (HTTP 400) signifie que la requête n'a pas été acceptée et n'entraîne généralement pas de frais de tâche de génération ; les règles de facturation, d'échec et de remboursement après le renvoi d'un ID de tâche sont régies par la configuration tarifaire du modèle et de la plateforme.

Variations de disponibilité

Si une fiche de modèle n'est pas affichée ou si un modèle est absent de /v1/models, cela signifie qu'il ne fait pas actuellement partie du catalogue disponible pour cette clé ; passez à un modèle équivalent et ne codez pas en dur dans le client le nom d'un modèle devenu indisponible.

« Aucun canal disponible » et « Modèle temporairement indisponible » signifient qu'il est actuellement impossible d'acheminer vers ce modèle, et non que le format de l'API Key est incorrect. Actualisez d'abord la liste des modèles ou passez à un modèle équivalent ; si l'indisponibilité persiste, contactez le support de la plateforme en fournissant l'ID de requête.