Endpoints
Todas as rotas que esta API monta, o que cada uma precisa, e as que as pessoas esperam mas que estão deliberadamente ausentes.
URL base nesta implementação: https://api.llmeu.com
| Método | Caminho | Credencial | Notas |
|---|---|---|---|
| GET | /healthz | nenhuma | Liveness. Não lê nada. |
| GET | /readyz | nenhuma | Readiness: base de dados, endpoints próprios, runtimes geridos. Responde 503 enquanto uma GPU ainda está a carregar os pesos. |
| GET | /v1/models | chave · inferência | Apenas os modelos que esta chave pode realmente chamar ao abrigo da política predefinida da sua organização. |
| GET | /v1/models/{id} | chave · inferência | Um modelo, com a sua licença e se está alojado aqui. |
| POST | /v1/chat/completions | chave · inferência | O endpoint de chat compatível com OpenAI, com ou sem streaming. |
| POST | /v1/completions | nenhuma | Não é oferecido. Responde 501 not_implemented e indica o endpoint a usar em alternativa. |
| POST | /v1/embeddings | chave · inferência | Embeddings de um modelo de embeddings. Esta implementação serve-os a partir do seu backend local determinístico, e a resposta di-lo: llmeu.mock é true no corpo. |
| POST | /v1/playground | nenhuma | Anónimo, apenas backend mock, e limitado por endereço IP. |
| GET | /platform/v1/me | chave · platform_read | A organização à qual esta credencial pertence. |
| GET | /platform/v1/api-keys | chave · platform_read | As chaves da organização, sem segredos. |
| POST | /platform/v1/api-keys | chave · platform_write | Crie uma chave. O segredo aparece nesta resposta e nunca mais. |
| DELETE | /platform/v1/api-keys/{id} | chave · platform_write | Revogar uma chave. Com efeito no próximo pedido. |
| GET | /platform/v1/traces | chave · platform_read | Metadados registados de chamadas anteriores. Sem corpos de prompt ou completion: a retenção é zero. |
| GET | /platform/v1/traces/{id} | chave · platform_read | Um trace, incluindo a decisão de encaminhamento. |
| GET | /platform/v1/usage | chave · platform_read | Utilização agregada por dia e por modelo. |
| GET | /platform/v1/policies | chave · platform_read | As políticas da organização. |
| GET | /platform/v1/policies/{id} | chave · platform_read | Uma política. |
| POST | /platform/v1/policies | chave · platform_write | Criar uma política. |
| PUT | /platform/v1/policies/{id} | chave · platform_write | Editar uma política. Aplica-se ao próximo pedido, não a um já em curso. |
| GET | /platform/v1/status | nenhuma | Estado da implementação. Não requer credencial, por isso trate-o como não confidencial. |
O que não está aqui
Não existe /v1/files, /v1/batches, /v1/assistants, /v1/fine_tuning, /v1/images, /v1/audio nem /v1/moderations. Não estão montados, por isso respondem 404 unknown_route em vez de um 501 que implicaria que estão para chegar. Não há webhooks nem SDK: qualquer cliente compatível com OpenAI é o SDK.
Estado sem chave
Este endpoint não requer credencial, o que torna público o estado da própria implementação. Está escrito aqui em vez de ser descoberto mais tarde, porque é uma decisão de produto: se a sua política precisa de uma sonda de estado autenticada, altere-a deliberadamente. A resposta nunca contém dados da organização.