Primeiro, identifique a etapa com falha
Verifique o status do serviço e depois separe problemas de acesso à conta, autenticação da API, descoberta de modelo, inferência e pagamento. Um modelo aparecer no catálogo não estabelece disponibilidade ao vivo: GET /v1/models lista implantações conectadas.
Um 503 service_unavailable significa que o serviço necessário não pode aceitar a solicitação. Verifique o status do serviço e a referência da API antes de tentar novamente; solicitações repetidas não podem habilitar um serviço indisponível. Para uma GPU dedicada, aguarde o provisionamento confirmado. Para pagamentos, siga as instruções da ordem e o status de verificação registrado; atualizar uma ordem não adiciona crédito.
Lavora a partire dalla risposta, non da un'ipotesi
Registra lo stato HTTP e i valori code e message dell'errore. Controlla l'URL base dell'API configurato, l'ID esatto del modello e la versione del client prima di modificare la logica dell'applicazione.
- 401: verifica l'header Bearer e se la chiave è stata revocata. Non inserire la chiave completa nei log.
- 403: scegli un modello consentito dall'elenco di modelli consentiti della chiave (allowlist).
- 400 o 413: controlla il JSON, i campi obbligatori, il limite di output e il budget di contesto combinato input/output.
- 402: verifica se l'account dispone di una ricarica confermata valida di almeno 100 USD, quindi controlla il credito disponibile e il budget della chiave selezionata; gli account qualificati non devono mantenere un saldo di 100 USD.
- 429: segui l'header Retry-After se fornito, usa tentativi limitati e controlla i limiti di servizio applicabili; non esiste un limite gratuito giornaliero di prova.
- 502 o 503: verifica la disponibilità e il messaggio di errore prima di un tentativo limitato.
La guida agli errori e i limiti spiegano i percorsi di ripristino. Una nuova richiesta può creare nuovo lavoro; non dare per scontato che i tentativi del client siano deduplicati.
Trate fluxos interrompidos e crédito pendente juntos
Uma aba do navegador fechada, tempo limite ou fluxo quebrado não prova que a geração parou. Salve qualquer identificador de resposta e o quadro de uso final, se recebido. O quadro de uso final pode chegar após o finish_reason da escolha; um pedaço de rede não é necessariamente um evento completo.
Um 409 pending_reconciliation, ou um erro upstream após o despacho, pode deixar o crédito reservado até que o uso autoritativo esteja disponível. Evite enviar solicitações duplicadas para liberar a retenção. Compare a hora UTC, o modelo e o nome da chave com o uso do console e retenha os detalhes da solicitação para reconciliação. Os tempos de liberação não são garantidos.
Para um problema de pagamento, registre a referência da ordem, o ativo, a rede, o valor e o status visível. Nunca envie outro pagamento apenas porque o primeiro está pendente. Saques de carteira estão indisponíveis no momento. Cancelar uma ordem de GPU paga antes da ativação devolve seu pagamento ao saldo da conta WeightsAPI; não transfere fundos para uma carteira.
Prepara prove che qualcuno possa riprodurre
Un report utile include l'operazione, il timestamp UTC, il percorso dell'endpoint, l'ID del modello, l'SDK o l'integrazione e la versione, l'impostazione di streaming, il limite di token in output, stato/errore, risultato atteso e risultato effettivo. Includi un riferimento di risposta o transazione solo se disponibile; il gateway attualmente non espone un ID di supporto su ogni errore.
Aggiungi il più piccolo esempio sintetico che riproduce il problema. Sostituisci conversazioni reali, record dei clienti e documenti privati con testo inventato. Includi i conteggi dei tentativi rilevanti e se il problema si ripete tra le richieste. Gli screenshot devono mostrare l'errore e il contesto dopo aver rimosso credenziali, saldi o identificatori che non intendi condividere.
Per un ordine di GPU dedicata, includi il riferimento dell'ordine, la configurazione e lo stato di pagamento o provisioning visibile. Un ordine in sospeso non è una macchina attiva.
Tieni fuori credenziali e contenuti dei clienti
Non includere mai un segreto API, un header Authorization, un cookie di sessione, una chiave privata del portafoglio, una frase di recupero o un file di ambiente completo. Un nome di chiave o un prefisso deliberatamente accorciato è sufficiente per distinguere le applicazioni. I riferimenti pubblici delle transazioni possono comunque collegare l'attività a un portafoglio; condividi solo ciò che è necessario per l'indagine.
Se una chiave è stata esposta, creane una sostitutiva, aggiorna l'applicazione e revoca la vecchia chiave. La revoca blocca nuove ammissioni; le richieste precedentemente ammesse vengono liquidate normalmente. Vedi autenticazione per la gestione delle chiavi.
Salve seu relatório e verifique os detalhes de contato
Copie e revise seu relatório, depois mantenha-o com a referência relevante da solicitação ou ordem. Copiar não envia um ticket. Contatos oficiais de suporte e horários de serviço não são publicados; use apenas um canal confirmado para compartilhar um relatório.
Metas de resposta, contatos de escalonamento e créditos de serviço não foram estabelecidos. Mantenha credenciais e conteúdo sensível do cliente fora do seu relatório.