Tu primera solicitud

Esta guía te acompaña paso a paso en tu primera llamada a la API desde cero. Antes de empezar, asegúrate de que:

1. Has creado una clave de API y has guardado la clave completa.
2. Tienes la Base URL: inicia sesión en la consola, abre el diálogo «Inicio rápido», elige un protocolo y cópiala. Los ejemplos siguientes usan https://<your-base-url> como marcador de posición: sustitúyelo por el tuyo.

La plataforma habla tres protocolos nativos; elige el que mejor te encaje: la facturación y el saldo son idénticos en todos ellos.

Protocolo compatible con OpenAI (recomendado por defecto)

Totalmente compatible con el SDK de OpenAI: apunta base_url a la plataforma y tu código actual sigue funcionando.

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (SDK de openai)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js (SDK de openai)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Protocolo Anthropic

Isomorfo a la API de Anthropic Messages: autentícate con x-api-key y envía anthropic-version:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Protocolo Gemini

Isomorfo a la API de Google GenAI: el ID del modelo va en la ruta y la autenticación usa x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

Verificar el resultado

Una solicitud correcta devuelve la respuesta del modelo (en el protocolo OpenAI está en choices[0].message.content). A partir de ahí puedes:

• Consultar el uso y la variación del saldo en la página «Uso» de la consola;
• Sustituir your-model por un ID de modelo real del catálogo de modelos (se admiten las modalidades de texto, imagen, audio, vídeo y archivo).

Errores habituales en la primera llamada

Consejos para producción: guarda la clave en una variable de entorno (por ejemplo OPENAI_API_KEY) en lugar de escribirla directamente en el código, y dale preferencia al SDK oficial frente a llamadas HTTP escritas a mano: el SDK absorbe los detalles de compatibilidad del protocolo.