Tu primer deployment

Elegir un modelo del catálogo

Los modelos conocidos no necesitan catalogEntry: sus capacidades, límites y precios ya se encuentran en el catálogo del adapter. Busca src/adapters/<provider>/catalog.json en el repositorio y elige un modelo incluido en ese catálogo (por ejemplo, gpt-5.5 para OpenAI).

Validar la configuración

POST /admin/deployments/resolve valida y resuelve exactamente el mismo cuerpo que usaría un POST /admin/deployments real, sin guardar nada ni tocar el cifrado de credenciales; utilízalo para comprobar la configuración de la solicitud. No contacta con el proveedor ni verifica la clave API:

curl -X POST "$GATEWAY/admin/deployments/resolve" \
  -H "Authorization: Bearer $MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "publicModel": "general",
    "adapterKey": "openai",
    "upstreamModel": "gpt-5.5",
    "credentials": { "apiKey": "sk-..." }
  }'

La respuesta muestra source: "catalog" (confirmando que reconoció el modelo; no se necesita catalogEntry), además de las operaciones y transports resueltos. Si source regresa "custom", el modelo no está en el catálogo y debes seguir la ruta del modelo personalizado en Creación de deployments.

Guardar el deployment

Envíal cuerpo validado al endpoint de creación:

curl -X POST "$GATEWAY/admin/deployments" \
  -H "Authorization: Bearer $MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "publicModel": "general",
    "adapterKey": "openai",
    "upstreamModel": "gpt-5.5",
    "credentials": { "apiKey": "sk-..." }
  }'

Comprobar la conexión

Crea una Virtual keys con permiso para utilizar general y asigna el secreto devuelto a API_KEY. Esta solicitud verifica tanto la configuración del gateway como la conexión upstream:

curl -X POST "$GATEWAY/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "general", "messages": [{ "role": "user", "content": "Say hi" }] }'

Comprueba que la respuesta contiene un mensaje del asistente. Una resolución exitosa por sí sola no prueba que las credenciales del proveedor o el acceso al modelo funcionen.