Utilisation

Pour les intégrations à l'étranger, la vérification de compte stable aujourd'hui est Profil. Utilisez-le pour lire les crédits, le niveau et le quota API restant avant les opérations importantes. Les points de terminaison d'utilisation dédiés doivent être traités comme étant basés sur un schéma : appelez uniquement les chemins présents dans GET /api/openapi.json.

Demande

Le profil utilise une requête normale authentifiée par le porteur :

GET /api/open/v1/profile
Authorization: Bearer FISHAUDIO_API_KEY

curl https://fishaudio.org/api/open/v1/profile \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

Réponse

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

Utilisez la réponse pour les garde-fous opérationnels, et non comme une réservation. D'autres travailleurs peuvent consommer le solde après que vous l'ayez vérifié.

Facturation et crédits

Stockez des instantanés de solde autour de lots coûteux. Si les clients demandent pourquoi un lot s'est arrêté, comparez l'instantané du profil de départ, le nombre de tâches terminées, le nombre de tâches ayant échoué et l'instantané de profil final.

Erreurs

Les erreurs de profil suivent la forme d’erreur partagée API. Si un futur point de terminaison d'utilisation apparaît dans le schéma, appliquez les mêmes règles de nouvelle tentative et de journalisation : enregistrez requestId, évitez de journaliser les clés API et suspendez la création de lots en cas de crédits insuffisants.