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

# Uso de APIMart en Cursor

> Guía detallada sobre cómo configurar y usar el servicio de API de APIMart en el editor de código con IA Cursor. Esta guía le ayudará a configurar la API de APIMart en Cursor para acceder a una amplia variedad de recursos de modelos de IA para el desarrollo de código.

## Requisitos previos

Antes de comenzar, asegúrese de:

1. **Tener Cursor instalado**\
   Descargue e instale la versión adecuada para su sistema operativo desde el [sitio web de Cursor](https://cursor.sh/)

2. **Tener una clave de API de APIMart**\
   Acceda a la [Consola de APIMart](https://apimart.ai/keys) para obtener su clave de API (comienza con `sk-`)

<Note>**Consejo:** Si aún no tiene una cuenta en APIMart, regístrese en [APIMart](https://apimart.ai) y obtenga una clave de API.</Note>

## Paso 1: Abrir la configuración de Cursor

Tras iniciar Cursor, abra la configuración:

1. Haga clic en el icono **⚙️ Configuración** (engranaje) en la esquina superior derecha
2. O use los atajos:
   * Windows/Linux: `Ctrl+Shift+J`
   * macOS: `Cmd+Shift+J`

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/main-interface.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=0cdb42d41c54585a4fdb57605722a617" alt="Cursor main interface" width="1200" height="800" data-path="images/integrations/cursor/main-interface.png" />
</Frame>

<caption>*Interfaz principal de Cursor: abra la configuración desde el engranaje en la parte superior derecha*</caption>

## Paso 2: Configurar los ajustes del modelo

### 2.1 Abrir la configuración del modelo

En Configuración:

1. Busque **Models** en la barra lateral izquierda
2. Abra la página de configuración del modelo

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/settings-models.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=58aa677bafc3c5baf2f1cecbadc2f6c7" alt="Cursor Settings - Models" width="1200" height="800" data-path="images/integrations/cursor/settings-models.png" />
</Frame>

<caption>*Encuentre "Models" en la barra lateral izquierda*</caption>

### 2.2 Usar OpenAI API Key

En la página de configuración del modelo:

1. Busque la sección **OpenAI API Key**
2. Haga clic en **Add new** o **Override OpenAI Base URL**

<Note>**Importante:** Cursor admite APIs compatibles con OpenAI, por lo que APIMart se puede configurar como un proveedor personalizado.</Note>

### 2.3 Configurar APIMart

Introduzca lo siguiente:

| Ajuste       | Valor                                          |
| ------------ | ---------------------------------------------- |
| **API Key**  | Su clave de API de APIMart (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://api.apimart.ai/v1`                    |

<Note>
  **Importante:** - La Base URL debe incluir el sufijo `/v1`: `https://api.apimart.ai/v1` - La clave de API debe ser la clave `sk-...` de la consola de APIMart - Tras guardar, Cursor usa los modelos de APIMart para la finalización y el chat
</Note>

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/api-config.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=96fdcd9f4cb5894281096afacc3e8157" alt="APIMart API configuration" width="1200" height="800" data-path="images/integrations/cursor/api-config.png" />
</Frame>

<caption>*Introduzca la API Key y la Base URL*</caption>

## Paso 3: Elegir modelos

### 3.1 Selección de modelos

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/api-model.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=162421d76a09a5831298a9cc6194fed4" alt="Model selection" width="1200" height="800" data-path="images/integrations/cursor/api-model.png" />
</Frame>

En la configuración del modelo puede elegir qué modelos usar.

**Familias disponibles:**

* **GPT-4/5**: potentes para generación y preguntas y respuestas de código complejo
  * `gpt-5`: el último GPT-5
  * `gpt-4o`: GPT-4o
  * `gpt-4o-mini`: más rápido y de menor costo

* **Claude**: potentes para comprensión y refactorización
  * `claude-sonnet-4-5-20250929`: Claude Sonnet 4.5
  * `claude-haiku-4-5-20251001`: Claude Haiku 4.5

* **Otros**
  * `gemini-2.0-flash-exp`: Google Gemini 2.0 Flash

<Tip>
  **Sugerencias:** - 💰 **Completado (económico):** `gpt-4o-mini` - 🚀 **Tareas difíciles (rendimiento):** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` - ⚡ **Baja latencia:** `gpt-4o-mini`, `gemini-2.0-flash-exp`
</Tip>

### 3.2 Modelos por función

Puede elegir diferentes modelos por función:

* **Chat**: conversaciones con la IA
* **Autocomplete**: sugerencias en línea
* **Cmd+K**: edición/generación rápida

Elija la mejor opción para cada flujo de trabajo.

## Paso 4: Comenzar a usar

Una vez configurado, puede usar las funciones de IA de Cursor.

### 4.1 AI Chat (`Cmd+L` / `Ctrl+L`)

1. Pulse `Cmd+L` (macOS) o `Ctrl+L` (Windows/Linux)
2. Haga una pregunta o asigne una tarea, por ejemplo:
   * "¿Cómo implemento quicksort?"
   * "Ayúdame a optimizar el rendimiento de este código"
   * "Explica cómo funciona esta función"

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/ai-chat.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=916680a9a52cc82daa87ba904e64944b" alt="AI Chat panel" width="1200" height="800" data-path="images/integrations/cursor/ai-chat.png" />
</Frame>

<caption>*Conversar con el asistente*</caption>

### 4.2 Finalización de código

1. Escriba como de costumbre en el editor
2. Cursor sugiere finalizaciones
3. Pulse `Tab` para aceptar

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/autocomplete.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=34992c1174e6019df9d21ea5b71bf1b6" alt="Autocomplete" width="1925" height="1025" data-path="images/integrations/cursor/autocomplete.png" />
</Frame>

<caption>*Ejemplo de finalización en línea*</caption>

### 4.3 Edición rápida (`Cmd+K` / `Ctrl+K`)

1. Seleccione código
2. Pulse `Cmd+K` (macOS) o `Ctrl+K` (Windows/Linux)
3. Describa la edición, por ejemplo:
   * "Añadir manejo de errores"
   * "Refactorizar esta función"
   * "Añadir anotaciones de tipo"

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/cursor/quick-edit.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=eab6aa4afabc8f28ff3cd246bb2ebea7" alt="Quick edit" width="1920" height="1031" data-path="images/integrations/cursor/quick-edit.png" />
</Frame>

<caption>*Edición rápida con Cmd+K*</caption>

### 4.4 Explicar código

1. Seleccione el código
2. Haga clic derecho en **Explain with AI** (o atajo)
3. La IA explica el comportamiento y la lógica

## Preguntas frecuentes

### Q1: ¿No se puede conectar a APIMart?

**Pruebe:**

1. **Base URL**: debe ser exactamente `https://api.apimart.ai/v1`
2. **API Key**: clave `sk-...` válida de la [consola](https://apimart.ai/keys)
3. **Red**: asegúrese de que `https://api.apimart.ai` sea accesible; puede que se requiera un proxy en algunas regiones

### Q2: ¿Respuestas lentas?

**Pruebe:**

1. Use un modelo más ligero (`gpt-4o-mini` en lugar de `gpt-4o`, o `gemini-2.0-flash-exp`)
2. Acorte el contexto: envíe menos código, haga preguntas más precisas
3. Verifique la latencia o el proxy si es necesario

### Q3: ¿Errores de API?

| Mensaje                     | Causa probable                 | Qué hacer                                  |
| --------------------------- | ------------------------------ | ------------------------------------------ |
| `401 Unauthorized`          | Clave incorrecta o expirada    | Vuelva a crear la clave y actualice Cursor |
| `429 Too Many Requests`     | Límite de tasa                 | Espere y vuelva a intentarlo               |
| `500 Internal Server Error` | Problema temporal del servidor | Vuelva a intentarlo más tarde              |
| `insufficient_quota`        | Saldo bajo                     | Recargue en la consola                     |

### Q4: ¿Uso y facturación?

Abra la [Consola de APIMart](https://apimart.ai/overview):

* 📊 Estadísticas de llamadas
* 💰 Desglose de costos
* 📈 Tendencias de uso
* 🔍 Registros de solicitudes

## Consejos

### 1. Use el contexto

* Abra archivos relacionados
* Haga referencia a archivos con `@filename`
* Haga referencia a carpetas con `@folder`

### 2. Prompts claros

**❌ Débil:**

```
optimize this
```

**✅ Fuerte:**

```
Optimize this function for performance:
1. Reduce nested loops
2. Prefer more efficient data structures
3. Add caching where helpful
```

### 3. Itere

Empiece pequeño → refine → pruebe → ajuste prompts.

### 4. Reglas del proyecto

Defina estilo, nomenclatura, arquitectura y pruebas en `.cursorrules`.

## Características

Con Cursor + APIMart:

* 💬 Chat para preguntas de programación
* ⚡ Finalización inteligente
* ✏️ Ediciones en lenguaje natural
* 🔍 Comprensión profunda del código
* 🐛 Ayuda con la depuración
* 📝 Documentación y comentarios
* 🔄 Refactorización
* 🧪 Estructura de pruebas

## Soporte

* 📚 [Documentación de APIMart](https://docs.apimart.ai)
* 💬 [Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Comience con APIMart" icon="rocket" href="https://apimart.ai">
  ¡Regístrese, obtenga su clave de API y desarrolle más rápido con Cursor!
</Card>