Documentação da API

O CromIA foi desenhado para ser um Drop-in Replacement da OpenAI. Isso significa que você não precisa aprender nenhuma biblioteca nova. Basta trocar a URL Base e a sua Chave de API nos SDKs oficiais.

1. Endpoints Básicos

POST https://cromia-api.crom.me/v1/chat/completions

Gera uma resposta de modelo de linguagem baseada no array de mensagens enviado. Compatível com a rota oficial da OpenAI.

GET https://cromia-api.crom.me/v1/models

Lista os modelos atualmente ativos na infraestrutura CROM e que podem ser consumidos por você.

2. Endpoints de Integração REST (Autenticação e Painel)

Você pode integrar o faturamento, gerenciamento de chaves e controle de saldo do CromIA em outros sistemas usando os endpoints REST abaixo.

POST /v1/auth/login

Autentica o usuário e retorna o token de sessão REST.

Exemplo de Payload (JSON):

{
  "username": "pedrodev",
  "password": "MinhaSenhaSuperSegura"
}

Exemplo de Resposta (JSON):

{
  "token": "1.d9613fcfb3394510...",
  "user": {
    "id": 1,
    "username": "pedrodev",
    "balance": 150.50
  }
}
POST /v1/auth/register

Cadastra um novo usuário no ecossistema com saldo inicial zero (0.0).

Exemplo de Payload (JSON):

{
  "username": "novousuario",
  "password": "SenhaSegura123"
}

Exemplo de Resposta (JSON):

{
  "status": "success",
  "message": "User registered successfully with zero balance. To add credits, please contact one of the CROM Guardians (mrj.crom@gmail.com).",
  "user": {
    "id": 42,
    "username": "novousuario",
    "balance": 0.0
  }
}
GET /v1/admin/me

Retorna as informações do perfil do usuário e saldo atual. Requer o token de sessão no cabeçalho Authorization: Bearer <TOKEN>.

GET /v1/admin/keys

Lista as chaves de API ativas do usuário. Requer o token de sessão.

POST /v1/admin/keys

Gera uma nova chave de API para o usuário.

Payload (JSON):

{
  "name": "Nome do meu app"
}
DELETE /v1/admin/keys/{id}

Revoga/desativa uma chave de API existente. Requer o token de sessão.

3. Autenticação (Headers)

Todas as chamadas à API precisam de autenticação via Bearer Token. A chave deve ser gerada no seu Dashboard. 

Authorization: Bearer crom_sk_...
Content-Type: application/json

4. Exemplo Prático (cURL)

curl https://cromia-api.crom.me/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CROM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "system",
        "content": "Você é um assistente prestativo."
      },
      {
        "role": "user",
        "content": "Qual é a velocidade de andorinha sem carga?"
      }
    ]
  }'

5. Como Participar

O CromIA é o gateway de inteligência artificial construído para centralizar e simplificar o acesso a LLMs para projetos da comunidade CROM. O acesso é exclusivo e mediante aprovação.

Solicitar Afiliação

Envie um e-mail para: mrj.crom@gmail.com