Uso

Para integrações no exterior, a verificação de conta estável hoje é Perfil. Use-o para ler créditos, nível e cota API restante antes de grandes operações. Os terminais de uso dedicados devem ser tratados como orientados por esquema: chame apenas caminhos presentes em GET /api/openapi.json.

Solicitar

O perfil usa uma solicitação normal autenticada pelo 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"

Resposta

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

Use a resposta como proteção operacional, não como uma reserva. Outros trabalhadores podem consumir o saldo após você verificá-lo.

Faturamento e créditos

Armazene instantâneos de saldo em lotes caros. Se os clientes perguntarem por que um lote foi interrompido, compare o instantâneo do perfil inicial, a contagem de trabalhos concluídos, a contagem de trabalhos com falha e o instantâneo do perfil final.

Erros

Os erros de perfil seguem o formato de erro API compartilhado. Se um endpoint de uso futuro aparecer no esquema, aplique as mesmas regras de nova tentativa e registro em log: registre requestId, evite registrar chaves API e pause a criação de lote em caso de créditos insuficientes.