Cómo llamar a una API y elegir una plataforma de API

Ya hemos cubierto conceptos clave como API, Token y Temperature. Ahora toca la parte práctica: ¿Cómo llamar realmente a una API?

Mucha gente piensa que las APIs son algo misterioso, pero una vez que entiendes unos pocos elementos clave, llamar a una API es tan sencillo como comprar por internet. Este capítulo te guiará paso a paso.

Tres elementos fundamentales para llamar a una API

No importa qué herramienta o plataforma uses, llamar a una API de IA requiere estas tres cosas:

1. API Key

API Key = Tu identificación

Igual que necesitas un PIN para sacar dinero del cajero, llamar a una API requiere una API Key para demostrar “Soy yo, puedes atenderme”.

¿Cómo es una API Key?

Normalmente es una larga cadena de letras y números, por ejemplo:

sk-REPLACE_WITH_YOUR_API_KEY

Recordatorio importante:

Las API Keys son privadas; no las compartas con nadie.
Si alguien obtiene tu clave, puede usar tu cuenta para llamar a APIs (gastando tu dinero).
Si la filtras accidentalmente, elimina la clave antigua en la plataforma inmediatamente y genera una nueva.

2. Base URL

Base URL = La dirección del restaurante

Cuando pides comida a domicilio, necesitas saber dónde está el restaurante. Cuando llamas a una API, necesitas saber dónde está el servidor.

Base URLs comunes:

OpenAI: https://api.openai.com/v1
Anthropic Claude: https://api.anthropic.com/v1
Google Gemini: https://generativelanguage.googleapis.com/v1
DeepSeek: https://api.deepseek.com/v1

Las plataformas de terceros tienen URLs diferentes, pero el formato es similar.

3. Nombre del modelo

Nombre del modelo = El plato que quieres pedir

En un restaurante, dices “Quiero cerdo estofado”. Al llamar a una API, dices “Quiero usar GPT-5.2”.

Nombres de modelos comunes:

OpenAI: gpt-5.2, gpt-5.2-chat-latest
Claude: claude-opus-4.5, claude-sonnet-4.5
Gemini: gemini-3-pro, gemini-3-flash
DeepSeek: deepseek-chat, deepseek-coder

Un ejemplo completo de llamada a una API

Combina estas tres cosas, y la llamada a una API más simple se ve así:

import openai

# 1. Set the API Key
openai.api_key = "sk-proj-YOUR_API_KEY"

# 2. Set the Base URL (if you use a third-party platform)
openai.base_url = "https://api.openai.com/v1"

# 3. Call the selected model
response = openai.chat.completions.create(
    model="gpt-5.2",  # Model Name
    messages=[
        {"role": "user", "content": "Hello"}
    ]
)

print(response.choices[0].message.content)

¿Parece complicado? No te preocupes, las plataformas que presentaremos más adelante tienen métodos más sencillos.

API oficial vs. plataformas de terceros

Antes de presentar plataformas específicas, aclaremos un concepto importante: ¿Cuál es la diferencia entre las APIs oficiales y las plataformas de terceros?

API oficial

API oficial = Comprar directamente a OpenAI, Anthropic, Google

Ventajas:

Mejor estabilidad, conexión directa a los servidores oficiales
Funciones completas, las nuevas características se admiten de inmediato
Máxima seguridad, los datos no pasan por terceros

Desventajas:

Requiere una tarjeta de crédito extranjera
Requiere una VPN para acceder (ChatGPT, Claude, Gemini)
Precios relativamente más altos
El registro puede tener barreras

Plataformas de terceros

Plataformas de terceros = Comprar a revendedores

Las plataformas de terceros compran cuotas de API a los oficiales y luego te las revenden.

Ventajas:

Acepta pagos nacionales (Alipay, WeChat Pay, UnionPay)
No requiere VPN
Generalmente tienen interfaz y atención al cliente en chino
Una plataforma puede llamar a múltiples IAs (OpenAI, Claude, Gemini, etc.)
Algunas plataformas ofrecen créditos gratuitos

Desventajas:

La estabilidad puede no ser tan buena como la oficial
Los precios pueden ser ligeramente más altos que los oficiales (pero algunos son más baratos)
La seguridad requiere confiar en la plataforma
Las actualizaciones de funciones pueden ir por detrás de las oficiales

¿Cuál deberías elegir?

Elige oficial si:

Tienes una tarjeta de crédito extranjera
Tienes una VPN estable
Valoras la seguridad de los datos
Necesitas las últimas funciones

Elige terceros si:

No tienes métodos de pago extranjeros
No tienes VPN
Quieres usar pagos nacionales
Quieres llamar a múltiples IAs desde una sola plataforma

Recomendaciones de plataformas (2 nacionales + 2 internacionales)

A continuación, cuatro plataformas de API que recomiendo, dos nacionales y dos internacionales, que cubren diferentes necesidades.

1. DeepSeek Official (Nacional, Plataforma oficial)

Sitio web: https://platform.deepseek.com

Tipo de plataforma: Plataforma oficial

¿Por qué lo recomiendo?

Plataforma oficial, estable y fiable
El rendimiento de DeepSeek V3.2 está cerca de GPT-5
Acceso rápido en China, no necesita VPN
Registro sencillo, solo un número de teléfono
Precio extremadamente bajo, gran relación calidad-precio

Pasos para obtener la API Key:

Abre https://platform.deepseek.com
Haz clic en “Iniciar sesión / Registrarse” en la esquina superior derecha
Regístrate con tu número de teléfono
Después de iniciar sesión, haz clic en “API Keys” a la izquierda
Haz clic en “Crear API Key”
Copia la clave (solo se muestra una vez, así que guárdala)
Haz clic en “Documentación de la interfaz” a la izquierda para ver la URL y el nombre del modelo

Parámetros de llamada:

Base URL: https://api.deepseek.com
Nombre del modelo: deepseek-chat (chat), deepseek-reasoner (razonamiento)
API Key: La clave que acabas de copiar

2. Volcano Engine (Nacional, Plataforma oficial + Terceros)

Sitio web: https://console.volcengine.com/ark

Tipo de plataforma: Plataforma oficial (de ByteDance)

¿Por qué lo recomiendo?

Plataforma oficial de ByteDance, estable y fiable
Soporta modelos de la serie Doubao
Acepta pagos nacionales (Alipay, WeChat Pay, UnionPay)
Asequible, gran relación calidad-precio
Además de los modelos propios de Doubao, también puedes llamar a muchos modelos de código abierto nacionales como DeepSeek V3.2, GLM 4.7

Pasos de uso:

Abre https://console.volcengine.com/ark
Regístrate con tu número de teléfono
Entra en la consola “Ark Large Model”
Completa la autenticación de identidad real (requiere DNI)
Haz clic en “Gestión de API Key”
Crea una nueva API Key
Copia y guarda la clave
Haz clic en “Gestión de activación” a la izquierda, selecciona el modelo que quieras usar
En la nueva página, copia el nombre del modelo que necesitas (nota: el mismo modelo puede tener nombres diferentes en distintas plataformas, así que verifica cuidadosamente)
Vuelve a la página de Gestión de activación, comprueba si el estado es “Activado”; si no, haz clic a la derecha para activar los permisos del modelo

Parámetros de llamada:

Base URL: https://ark.cn-beijing.volces.com/api/v3
Nombre del modelo: doubao-pro-32k, doubao-lite-32k, etc.
API Key: La clave que creaste

Beneficios para nuevos usuarios:

Créditos gratuitos al registrarse
También puedes participar en la actividad que se muestra arriba de la captura de pantalla para obtener más créditos gratuitos. Yo tengo más que suficientes cada día.

3. Google AI Studio (Internacional, Plataforma oficial)

Sitio web: https://aistudio.google.com

Tipo de plataforma: Plataforma oficial

¿Por qué lo recomiendo?

Plataforma oficial de Google
Créditos gratuitos disponibles (con límites)
Gemini 3 con rendimiento de primer nivel
Estable y fiable
Soporta contexto extremadamente largo (2 millones de tokens)
Se puede usar gratis directamente en la interfaz web, sin necesidad de programar

Además, cómo usar la versión web gratis

Si no quieres escribir código, Google AI Studio ofrece una interfaz de chat web muy conveniente donde puedes usar directamente modelos como Gemini 3 Pro y Gemini 3 Flash. Es esencialmente como ser un usuario de pago de Gemini.

Pasos de uso:

Abre https://aistudio.google.com
Inicia sesión con tu cuenta de Google (se requiere VPN)
Haz clic en “Playground” a la izquierda
En la esquina superior derecha, selecciona un modelo:
- gemini-3-pro: Mejor modelo, adecuado para tareas complejas
- gemini-3-flash: Modelo rápido, adecuado para conversaciones diarias
- Otros modelos experimentales disponibles
Escribe tu pregunta directamente en el cuadro de entrada, luego haz clic en “Run”, y la IA responderá

Funciones avanzadas (versión web):

1. Subir archivos

Haz clic en el icono + a la derecha del cuadro de entrada
Puedes subir imágenes, PDFs, documentos, etc.
Soporta comprensión multimodal

2. Ajustar parámetros

A la derecha, puedes ajustar los parámetros que presentamos antes
Puedes ajustar:
- Temperature (creatividad)
- Top P
- Máximo de tokens de salida
- Configuración de seguridad

Ventajas de la versión web:

No requiere programación
No necesita instalación de software
Se usa directamente en el navegador
Interfaz amigable, funciones completas
Adecuada para pruebas rápidas y uso diario

¿Para quién es la versión web?

Principiantes absolutos que no saben programar
Aquellos que quieren probar rápidamente las capacidades de Gemini
Chatear y hacer preguntas a diario
Manejar tareas multimodales como documentos e imágenes

Obtener API Key (Para usuarios avanzados)

Volviendo al tema principal, así es como se obtiene una API Key.

Pasos para obtener la API Key:

En la página de AI Studio, haz clic en “Get API Key” a la izquierda
Haz clic en “Create API Key”
Crea y copia la API Key generada
Vuelve a Playground, selecciona y copia el nombre del modelo a la derecha

Parámetros de llamada:

Base URL: https://generativelanguage.googleapis.com/v1beta
Nombre del modelo: gemini-3-flash-preview
API Key: La clave que copiaste

Límites del nivel gratuito

¡Importante! Google AI Studio usa el nivel gratuito por defecto, con los siguientes límites (a enero de 2026), y estos límites están sujetos a cambios:

Solicitudes por minuto (RPM): 15
Solicitudes por día (RPD): 1500
Tokens por minuto (TPM): 1 millón de tokens

Consulta los límites detallados en: https://ai.google.dev/gemini-api/docs/rate-limits?hl=en

¿Es suficiente el nivel gratuito?

Chat web: Más que suficiente
Llamadas ocasionales a la API: Suficiente
Llamadas automatizadas intensivas: Puede no ser suficiente

¿Cómo eliminar los límites? Vincula tus créditos en la nube

Google Cloud ofrece $10 en créditos gratuitos a nuevos usuarios. Después de vincularlo a AI Studio, puedes desbloquear límites más altos. Para más detalles sobre cómo configurar una cuenta de Google Cloud, busca en internet “créditos gratuitos de Google Cloud”: hay muchos tutoriales. No lo cubriremos aquí.

Pasos para vincular:

En AI Studio, vuelve a la interfaz de la API y haz clic en “Set up billing”
Vincula la cuenta de facturación de Google Cloud que creaste anteriormente

Beneficios después de vincular:

Los límites de velocidad aumentan significativamente (RPM hasta 1000+)
Los créditos gratuitos siguen siendo válidos
$10 pueden durar mucho tiempo con el potente modelo flash
Tanto la versión web como la API disfrutan de cuotas más altas

4. OpenRouter (Internacional, Plataforma de terceros)

Sitio web: https://openrouter.ai

Tipo de plataforma: Plataforma de terceros

¿Por qué lo recomiendo?

Una plataforma para llamar a todas las IAs principales (GPT, Claude, Gemini, etc.)
Precios transparentes, a veces más baratos que los oficiales
Acepta pagos con Alipay (amigable para usuarios chinos)
Acepta tarjetas de crédito y criptomonedas
Modelos gratuitos disponibles para probar
Puede llamar a casi todos los modelos disponibles
Los rankings son convincentes

Pasos para obtener la API Key:

Abre https://openrouter.ai
Haz clic en “Sign In” en la esquina superior derecha, inicia sesión con Google o GitHub
Después de iniciar sesión, haz clic en tu avatar en la esquina superior derecha y selecciona “Keys”
Haz clic en “Create Key”
Dale un nombre a la clave y haz clic en crear
Copia la clave generada
Busca el modelo que quieras en el cuadro de búsqueda y luego copia el nombre

Parámetros de llamada:

Base URL: https://openrouter.ai/api/v1
Nombre del modelo:
- GPT-5.2: openai/gpt-5.2
- Claude Opus 4.5: anthropic/claude-opus-4.5
- Gemini 3 Pro: google/gemini-3-pro
- Modelo gratuito: meta-llama/llama-3.1-8b-instruct:free
API Key: La clave que creaste

Métodos de recarga:

Alipay (el más conveniente)
Tarjeta de crédito
Criptomonedas (USDC, etc.)

Ventaja de precio:

Algunos modelos son 10-20% más baratos que los oficiales
Precios transparentes, ves los precios directamente en el sitio web
Diferentes proveedores compiten, tú eliges el más barato

Opciones gratuitas:

Algunos modelos son completamente gratuitos (marcados con :free)
Los nuevos usuarios obtienen créditos gratuitos para probar
Puedes probar primero con modelos gratuitos

Rankings de modelos

En la página de Rankings, puedes ver los datos de llamadas a modelos de la plataforma; los rankings son muy convincentes.

Otras plataformas gratuitas

Debido a limitaciones de espacio, aquí hay algunas otras plataformas que puedes usar de forma gratuita:

Cerebras (Inferencia ultrarrápida)

Sitio web: https://cloud.cerebras.ai

Características:

Inferencia extremadamente rápida (afirma ser la más rápida del mundo)
Ofrece llamadas gratuitas al modelo Llama
Registro sencillo, solo inicia sesión con GitHub

NVIDIA NIM (Oficial de NVIDIA)

Sitio web: https://build.nvidia.com

Características:

Plataforma oficial de IA de NVIDIA
Ofrece múltiples modelos gratuitos
Adecuada para pruebas y desarrollo

Ambas plataformas ofrecen créditos gratuitos. Si te interesa, puedes registrarte y probarlas.

Resumen

Tres elementos fundamentales:

API Key
Base URL
Nombre del modelo

Cuatro plataformas recomendadas:

DeepSeek Official (Oficial) - Mejor opción de bajo costo en China
Volcano Engine (Oficial + Terceros) - Plataforma nacional, puede llamar a la mayoría de los modelos de código abierto nacionales
Google AI Studio (Oficial) - Mejor opción gratuita a nivel internacional (con Cloud Credits), se puede usar directamente en la web
OpenRouter (Terceros) - Plataforma todo en uno, acepta Alipay