> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración de API

> Configura las claves API de modelos de IA en SoloEnt

Configura las claves API para habilitar las funciones de escritura con IA de SoloEnt.

## Puntos de acceso

### Configuración rápida desde el chat

<Steps>
  <Step title="Haz clic en el nombre del modelo en la parte inferior del chat">
    Haz clic en el nombre del modelo en la parte inferior del chat del Agent para abrir el panel de configuración del modelo.
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=a380930952d0ba22b51d93be0f9a74f3" alt="Configuración rápida de API desde el chat" style={{ width: '70%', maxWidth: '400px', display: 'block' }} width="686" height="272" data-path="assets/images/apikey_1.png" />

### Desde el panel de configuración

<Steps>
  <Step title="Abrir configuración del Agent">
    Haz clic en el icono de configuración del panel del Agent.
  </Step>

  <Step title="Ir a configuración de modelos">
    Elige si usar directamente los modelos oficiales o configurar tu propio modelo (BYOK).
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_3.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=261ac83f5e7036db95d25d509c2cc432" alt="Configuración de API desde el panel de configuración" style={{ width: '70%', maxWidth: '400px', display: 'block' }} width="812" height="1072" data-path="assets/images/apikey_3.png" />

## API oficial

SoloEnt ofrece una API oficial. Una vez que inicies sesión, puedes usarla directamente sin configurar ninguna clave de terceros.

### Modelos gratuitos

Los modelos gratuitos oficiales están disponibles inmediatamente después de iniciar sesión. Los modelos gratuitos disponibles y los descuentos se actualizan con regularidad junto con las campañas en curso.

<Note>
  Cada usuario registrado recibe un crédito de prueba de **\$0.5**; participa en las [actividades de la plataforma](https://soloent.ai/es/activities) para ganar más crédito gratuito.
</Note>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_4.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=da746ca341868270d88d79da60e4fd00" alt="Panel de configuración que muestra SoloEnt AI como proveedor de API con la pestaña Free listando los modelos gratuitos disponibles" style={{ width: '70%' }} width="720" height="948" data-path="assets/images/apikey_4.png" />

<Warning>
  Los modelos gratuitos sirven para probar la herramienta. Los tiempos de respuesta pueden ser más lentos o menos consistentes en periodos de alta demanda.
</Warning>

### Modelos de suscripción (VIP)

Los suscriptores de Lite, Pro y Max pueden usar todos los modelos de la lista VIP —que incluye los últimos modelos de los principales proveedores como Anthropic, OpenAI, Google y DeepSeek— sin configurar ninguna clave API de terceros.

<Note>
  Los precios de la API de SoloEnt coinciden con los precios oficiales de cada proveedor de modelos, sin comisiones adicionales, y distintos modelos ofrecen distintos descuentos de forma periódica.
</Note>

Consulta todos los modelos oficiales y los últimos descuentos en [soloent.ai/en/models](https://soloent.ai/en/models).

***

## Configurar una clave API de terceros

Una clave API es tu credencial de autenticación para acceder a los modelos de IA; suele ser una cadena aleatoria:

```
sk-abc123xyz456def789ghi012jkl345mno678pqr901stu234
```

<Warning>
  **Importante:** El acceso a la API se factura por separado de las suscripciones mensuales. Una suscripción de \$20 no incluye el uso de la API. Por ejemplo, una membresía de Gemini a la que estés suscrito no puede usarse aquí como API.
</Warning>

### Dónde obtener claves API

#### Proveedores populares

| Proveedor       | Últimos modelos                    | Ideal para                                                              |
| --------------- | ---------------------------------- | ----------------------------------------------------------------------- |
| **OpenAI**      | GPT-5.6                            | Investigación para escritura, escritura general                         |
| **Anthropic**   | Claude Sonnet-5 / Opus-5 / Fable-5 | Planificación de historias, pensamiento estratégico, escritura de prosa |
| **Google**      | Gemini-3.1-pro                     | Rápido, económico, escritura de prosa, multimodal                       |
| **xAI**         | Grok-4.5                           | Información en tiempo real, política de contenido flexible, multimodal  |
| **DeepSeek**    | DeepSeek-V4-pro                    | Económico, política de contenido flexible                               |
| **Zhipu AI**    | GLM-5.2                            | Planificación de historias, contenido en chino                          |
| **Moonshot AI** | Kimi-K3                            | Contexto largo, contenido en chino                                      |
| **OpenRouter**  | Varios modelos                     | Acceso unificado, comparación de modelos                                |

<Tip>
  Consulta el [directorio completo de API](../resources/api-directory) para obtener información detallada de los proveedores y los pasos de registro.
</Tip>

<Card title="Obtener claves API gratuitas" icon="gift" href="../resources/free-api-keys">
  Explora opciones de nivel gratuito y recursos de la comunidad
</Card>

### Rellenar correctamente los datos de la API que compraste

#### Configuración estándar (proveedores oficiales)

Para OpenAI, Anthropic, Google y algunos agregadores: busca el proveedor de modelos correspondiente en el desplegable API Provider e introduce solo la API Key:

```plaintext theme={null}
API Key: sk-abc123xyz456...
```

#### Configuración compatible con OpenAI (terceros)

Selecciona **OpenAI Compatible** en el desplegable API Provider para configurar un proveedor de terceros.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/zh/faq_api_openai.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=eb6732c3e8b473cb83128b64173916ce" alt="Panel de API Configuration con el desplegable API Provider desplegado y la opción OpenAI Compatible resaltada" style={{ width: '70%' }} width="934" height="992" data-path="assets/images/zh/faq_api_openai.png" />

La mayoría de los proveedores de terceros requieren los tres campos:

<ParamField path="base_url" type="string" required>
  URL del endpoint de la API (p. ej., `https://api.provider.com/v1`)
</ParamField>

<ParamField path="api_key" type="string" required>
  Tu clave API
</ParamField>

<ParamField path="model_id" type="string" required>
  Identificador del modelo (p. ej., `gpt-4-turbo`)
</ParamField>

<Warning>
  Los tres campos son obligatorios. Confirma con tu proveedor antes de comprar.
</Warning>

#### LLMs locales

Ejecuta modelos de IA en tu propia computadora para mayor privacidad y acceso sin conexión.

| Solución      | Modelos                    | Ideal para                          |
| ------------- | -------------------------- | ----------------------------------- |
| **Ollama**    | Llama 3.1, Qwen, DeepSeek  | Configuración sencilla, macOS/Linux |
| **LM Studio** | Varios modelos abiertos    | Interfaz gráfica, multiplataforma   |
| **vLLM**      | Despliegues personalizados | Alto rendimiento, producción        |

<Card title="Guía de configuración de modelos locales" icon="laptop" href="../resources/local-llms">
  Guía completa para ejecutar modelos localmente
</Card>

## Usar una suscripción de Codex / Claude Code en SoloEnt

Si ya tienes una suscripción de OpenAI Codex o Claude Code, puedes reutilizar ese crédito directamente en SoloEnt mientras disfrutas de las Skills de escritura profesional de SoloEnt, sin necesidad de comprar una clave API por separado.

#### Usar una suscripción de Codex

Selecciona **BYOK**, elige **OpenAI Codex** en la lista API Provider y haz clic para iniciar sesión en OpenAI Codex. Una vez iniciada la sesión, puedes seleccionar los modelos que ofrece Codex (como GPT-5.x) en la lista de modelos. No se necesita ninguna clave API adicional al usar una suscripción de ChatGPT Plus o Pro.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/codex.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=0ec7f282fa0033e736f5ea351ab60a93" alt="Configuración BYOK con API Provider en OpenAI Codex, mostrando el botón Sign in to OpenAI Codex" style={{ width: '55%' }} width="642" height="1046" data-path="assets/images/codex.png" />

#### Usar una suscripción de Claude Code

Primero instala la **Claude Code CLI** en tu computadora y vincula tu cuenta de suscripción de Claude Code, asegurándote de que Claude Code funcione correctamente en local. Luego selecciona **BYOK**, elige **Claude Code** en la lista y, sin ninguna otra configuración, elige directamente el modelo de Claude que quieras en la lista de modelos.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/claudecode.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=cb4ad3d2c3c24fb07806b165fe8997c1" alt="Configuración BYOK con API Provider en Claude Code, mostrando la ruta de la Claude Code CLI y la selección de modelo" style={{ width: '55%' }} width="632" height="980" data-path="assets/images/claudecode.png" />

## Errores comunes

| Causa                    | Código de error | Mensaje de error                                       |
| ------------------------ | :-------------: | ------------------------------------------------------ |
| Falta el modelo          |      `400`      | `Missing model`                                        |
| Presupuesto excedido     |      `403`      | `Budget exceeded`                                      |
| Crédito gratuito agotado |      `403`      | `Daily free quota used up, please try again tomorrow.` |
| Modelo no encontrado     |      `404`      | `Model not found`                                      |

<Note>
  SoloEnt no puede diagnosticar con precisión, por el momento, otros errores causados por la inestabilidad de los modelos de terceros.
</Note>

## Otras preguntas frecuentes

<AccordionGroup>
  <Accordion title="Clave API no válida">
    * Verifica que copiaste la clave completa
    * Comprueba si la clave ha caducado
    * Regenérala desde la consola del proveedor
  </Accordion>

  <Accordion title="Falla la conexión">
    * Comprueba tu conexión a internet
    * Verifica la Base URL (para la configuración OpenAI Compatible)
    * Prueba sin VPN
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Configuración de idioma" icon="language" href="./language-settings">
    Configura tu idioma preferido
  </Card>

  <Card title="Empezar a escribir" icon="pen-to-square" href="../tips/create-project">
    Crea tu primer proyecto
  </Card>

  <Card title="Modelos locales" icon="laptop" href="../resources/local-llms">
    Ejecuta modelos de IA en tu computadora
  </Card>

  <Card title="Claves API gratuitas" icon="gift" href="../resources/free-api-keys">
    Obtén acceso gratuito a modelos de IA
  </Card>
</CardGroup>
