Laddro DocsLaddro Docs

Definicoes

Definicoes

Gerir as definicoes do modelo de IA. Utilize estes endpoints para configurar BYOK (Bring Your Own Key) para fornecedores de IA.

Obter Definicoes

GET /v1/settings

Devolve a configuracao atual do modelo de IA.

Pedido

curl https://api.laddro.com/v1/settings \
  -H "x-api-key: YOUR_API_KEY"

Resposta

{
  "data": {
    "model": {
      "provider": "openai",
      "modelId": "gpt-4o-mini",
      "isCustom": false
    }
  }
}

Se nenhum modelo personalizado estiver definido, isCustom e false e o modelo predefinido do sistema e utilizado (OpenAI gpt-4o-mini).

Definir Modelo de IA (BYOK)

PUT /v1/settings/model

Configure um fornecedor e modelo de IA personalizado utilizando a sua propria chave API. Requer uma subscricao recorrente Laddro ativa.

Corpo do Pedido

CampoTipoObrigatorioDescricao
providerstringSimNome do fornecedor (ex.: openai, anthropic)
modelIdstringSimID do modelo (ex.: gpt-4.1-mini)
apiKeystringSimA sua chave API para o fornecedor

Pedido

curl -X PUT https://api.laddro.com/v1/settings/model \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "anthropic",
    "modelId": "claude-haiku-4.5",
    "apiKey": "sk-ant-..."
  }'

Resposta

{
  "data": {
    "model": {
      "provider": "anthropic",
      "modelId": "claude-haiku-4.5",
      "isCustom": true
    }
  },
  "message": "Model updated successfully"
}

A sua chave API e validada com uma chamada de teste antes de ser guardada. Chaves invalidas sao rejeitadas com uma mensagem de erro clara.

Erros

EstadoDescricao
400Fornecedor ou ID de modelo invalido
401Chave API em falta ou invalida
403BYOK requer uma subscricao recorrente ativa
422Validacao da chave API do fornecedor falhou

Repor Modelo Predefinido

DELETE /v1/settings/model

Remova a configuracao de modelo personalizado e reverta para o modelo predefinido do sistema.

Pedido

curl -X DELETE https://api.laddro.com/v1/settings/model \
  -H "x-api-key: YOUR_API_KEY"

Resposta

{
  "data": {
    "model": {
      "provider": "openai",
      "modelId": "gpt-4o-mini",
      "isCustom": false
    }
  },
  "message": "Model reset to default"
}

Consulte o Guia BYOK para instrucoes de configuracao e fornecedores suportados.

On this page

DefinicoesObter DefinicoesPedidoRespostaDefinir Modelo de IA (BYOK)Corpo do PedidoPedidoRespostaErrosRepor Modelo PredefinidoPedidoResposta