Uso

Para integraciones en el extranjero, la verificación de cuenta estable actual es Perfil. Úselo para leer créditos, niveles y cuota restante de API antes de operaciones grandes. Los puntos finales de uso dedicado deben tratarse como basados ​​en esquemas: llame solo a las rutas presentes en GET /api/openapi.json.

Pedido

El perfil utiliza una solicitud normal autenticada por el portador:

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

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

Respuesta

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

Utilice la respuesta para las barreras operativas, no como una reserva. Otros trabajadores pueden consumir el saldo después de que usted lo verifique.

Facturación y créditos

Almacene instantáneas de saldos de lotes costosos. Si los clientes preguntan por qué se detuvo un lote, compare la instantánea del perfil inicial, el recuento de trabajos completados, el recuento de trabajos fallidos y la instantánea del perfil final.

Errores

Los errores de perfil siguen la forma de error compartida API. Si aparece un punto final de uso futuro en el esquema, aplique las mismas reglas de reintento y registro: registre requestId, evite registrar claves API y suspenda la creación de lotes si no hay créditos suficientes.