Fazer deploy
docs

Erros e limites

Os códigos de erro da Veloz AI, o que cada um significa e o que fazer, e os limites de requisições por minuto, de tamanho e de rotas.

Formato

Os erros seguem o formato da OpenAI, então os SDKs mostram a mensagem como ela veio:

{
  "error": {
    "message": "Créditos de IA insuficientes. Adicione créditos no painel da Veloz, em IA.",
    "type": "insufficient_quota",
    "code": "insufficient_credits"
  }
}

Códigos

Status code Quando O que fazer
400 invalid_body, model_not_supported_for_endpoint, unsupported_response_format, too_many_models Corpo sem model, modelo usado na rota errada (um modelo de embeddings em /chat/completions, por exemplo), response_format não aceito ou mais de 5 modelos somando model e models Corrija a requisição
401 invalid_api_key Chave ausente, inválida ou revogada Confira o cabeçalho Authorization e a chave
402 insufficient_credits Saldo de IA zerado e nenhum provedor próprio na lista Adicione créditos
403 invalid_api_key A chave é da Veloz, mas não foi criada para a Veloz AI Use uma chave criada em Inferência de IA
404 model_not_found, provider_not_configured O model não existe no catálogo, ou o provedor antes da barra não foi adicionado ou está pausado Veja os ids em GET /models ou veloz ai models; confira Provedores
413 request_too_large Requisição maior que 25 MB Envie menos conteúdo ou divida o áudio
424 provider_auth_failed O seu provedor recusou a chave cadastrada Troque a chave em Provedores
429 rate_limit_exceeded Mais de 300 requisições por minuto com a mesma chave Espere alguns segundos; os SDKs da OpenAI repetem sozinhos
502 provider_error, provider_unreachable O seu provedor respondeu com erro do lado dele, ou não foi possível falar com ele Tente de novo ou use um modelo de reserva
503 service_unavailable Indisponibilidade temporária do catálogo Tente de novo em instantes; os SDKs da OpenAI repetem sozinhos

O 402 não é repetido automaticamente pelos SDKs: sem saldo, repetir não adianta.

Outros erros 4xx vêm do próprio modelo ou do seu provedor, com a mensagem dele, por exemplo quando o texto passa do tamanho de contexto que o modelo aceita. Sem um código do modelo, eles chegam com request_rejected (catálogo) ou provider_rejected (provedor próprio).

Com modelos de reserva, qualquer erro de um modelo passa para o próximo da lista, e você recebe o erro do último só se todos falharem. Os erros da requisição em si (invalid_body, model_not_found, provider_not_configured, model_not_supported_for_endpoint e too_many_models) recusam a requisição antes de chamar qualquer modelo.

Limites

  • Requisições: 300 por minuto por chave, somando todas as rotas. Os cabeçalhos RateLimit-Remaining e RateLimit-Reset de cada resposta mostram quanto resta na janela e quando ela recomeça. Nos provedores próprios, valem também os limites da sua conta no provedor.
  • Tamanho da requisição: 25 MB, inclusive o áudio da transcrição.
  • Modelos por requisição: até 5, somando model e models.
  • Rotas: POST /chat/completions, POST /completions, POST /embeddings, POST /rerank, POST /audio/transcriptions, GET /models e GET /models/{id}. Geração de imagens, fala (text-to-speech), arquivos, batches e fine-tuning não estão disponíveis.