Laddro DocsLaddro Docs

Configuracion

Configuracion

Gestiona la configuracion del modelo de IA. Usa estos endpoints para configurar BYOK (Bring Your Own Key) para proveedores de IA.

Obtener configuracion

GET /v1/settings

Devuelve tu configuracion actual del modelo de IA.

Solicitud

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

Respuesta

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

Si no se ha configurado un modelo personalizado, isCustom es false y se usa el predeterminado del sistema (OpenAI gpt-4o-mini).

Configurar modelo de IA (BYOK)

PUT /v1/settings/model

Configura un proveedor de IA y modelo personalizado usando tu propia clave API. Requiere una suscripcion activa a Laddro.

Cuerpo de la solicitud

CampoTipoRequeridoDescripcion
providerstringSiNombre del proveedor (ej. openai, anthropic)
modelIdstringSiID del modelo (ej. gpt-4.1-mini)
apiKeystringSiTu clave API del proveedor

Solicitud

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-..."
  }'

Respuesta

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

Tu clave API se valida con una llamada de prueba antes de guardarse. Las claves invalidas se rechazan con un mensaje de error claro.

Errores

EstadoDescripcion
400Proveedor o ID de modelo invalido
401Clave API faltante o invalida
403BYOK requiere una suscripcion activa
422Validacion de la clave API del proveedor fallida

Restablecer al modelo predeterminado

DELETE /v1/settings/model

Elimina tu configuracion personalizada y vuelve al modelo predeterminado del sistema.

Solicitud

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

Respuesta

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

Consulta la Guia BYOK para instrucciones de configuracion y proveedores soportados.

On this page

ConfiguracionObtener configuracionSolicitudRespuestaConfigurar modelo de IA (BYOK)Cuerpo de la solicitudSolicitudRespuestaErroresRestablecer al modelo predeterminadoSolicitudRespuesta