Primeiro, identifique a etapa com falha
Verifique o status do serviço e depois separe problemas de acesso à conta, autenticação de API, descoberta de modelo, inferência e pagamento. Um modelo aparecendo 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.
Trabaja a partir de la respuesta, no de una suposición
Registra el estado HTTP y el code y el message del error. Comprueba la URL base de la API configurada, el ID exacto del modelo y la versión del cliente antes de cambiar la lógica de la aplicación.
- 401: comprueba la cabecera Bearer y si la clave fue revocada. No incluyas la clave completa en los registros.
- 403: elige un modelo permitido por la lista de permitidos de la clave.
- 400 o 413: comprueba el JSON, los campos obligatorios, el límite de salida y el presupuesto combinado de contexto de entrada/salida.
- 402: comprueba si la cuenta tiene una recarga confirmada que cumpla los requisitos de al menos USD 100; luego verifica el crédito disponible y el presupuesto de la clave seleccionada. Las cuentas que cumplen los requisitos no necesitan mantener un saldo de USD 100.
- 429: sigue la cabecera Retry-After si se proporciona, usa reintentos limitados y comprueba los límites de servicio aplicables; no hay una asignación diaria de prueba gratuita.
- 502 o 503: comprueba la disponibilidad y el mensaje de error antes de un reintento limitado.
La guía de errores y los límites explican las rutas de recuperación. Una nueva solicitud puede crear trabajo nuevo; no asumas que los reintentos del cliente se deduplican.
Trate fluxos interrompidos e crédito pendente juntos
Uma aba do navegador fechada, um tempo limite ou um 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 envio, pode deixar crédito reservado até que o uso autoritativo esteja disponível. Evite enviar solicitações duplicadas para liberar a retenção. Compare o horário UTC, modelo e 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, ativo, rede, valor e status visível. Nunca envie outro pagamento apenas porque o primeiro está pendente. Saques de carteira estão atualmente indisponíveis. Cancelar uma ordem de GPU paga antes da ativação devolve seu pagamento ao saldo da conta WeightsAPI; ele não transfere fundos para uma carteira.
Prepara pruebas que alguien pueda reproducir
Un informe útil incluye la operación, la marca de tiempo UTC, la ruta del endpoint, el ID del modelo, el SDK o la integración y su versión, la configuración de streaming, el límite de tokens de salida, el estado/error, el resultado esperado y el resultado real. Incluye una referencia de respuesta o transacción solo si está disponible; actualmente la pasarela no expone un ID de soporte en cada error.
Añade el ejemplo sintético más pequeño que reproduzca el problema. Sustituye conversaciones reales, registros de clientes y documentos privados por texto inventado. Incluye los recuentos de reintentos relevantes y si el problema se repite en distintas solicitudes. Las capturas de pantalla deben mostrar el error y el contexto después de eliminar credenciales, saldos o identificadores que no tengas intención de compartir.
Para un pedido de GPU dedicada, incluya la referencia del pedido, la configuración y el estado visible de pago o aprovisionamiento. Un pedido pendiente no es una máquina activa.
Mantén fuera las credenciales y el contenido de los clientes
Nunca incluyas un secreto de API, la cabecera Authorization, una cookie de sesión, una clave privada de monedero, una frase de recuperación ni un archivo de entorno completo. Un nombre de clave o un prefijo deliberadamente acortado es suficiente para distinguir aplicaciones. Las referencias de transacciones públicas aún pueden vincular la actividad a un monedero; comparte solo lo que la investigación necesite.
Si una clave quedó expuesta, crea una de reemplazo, actualiza la aplicación y revoca la clave antigua. La revocación bloquea nuevas admisiones; las solicitudes previamente admitidas se liquidan con normalidad. Consulta autenticación para el manejo de claves.
Salve seu relatório e verifique os detalhes de contato
Copie e revise seu relatório e depois mantenha-o com a solicitação ou referência de ordem relevante. Copiar não envia um ticket. Os contatos de suporte oficiais 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 confidencial do cliente fora do seu relatório.