APIMaster.ai
Documentación APIMaster.ai
Quick startAPIMaster.aiMarketplace

LiteLLM + APIMaster.ai

Conecta la API compatible con OpenAI de APIMaster.ai mediante el SDK de Python de LiteLLM o el Proxy de LiteLLM.

LiteLLM proporciona un SDK unificado para LLM y un servidor Proxy local. APIMaster.ai expone una API compatible con OpenAI — usa el formato openai/<id del modelo> y configura api_base.

Obtén primero una Clave API. Copia el id del modelo exacto desde el marketplace.

URL base:

https://apimaster.ai/v1

Formato del nombre del modelo en LiteLLM:

openai/<id del modelo de APIMaster>

Ejemplo: openai/claude-sonnet-4-6.

Prerrequisitos

  1. Python 3.10+ (se recomienda 3.11+).
  2. Una clave API de APIMaster desde la consola.
  3. Un id de modelo objetivo desde el marketplace.

Paso 1 — Instalar LiteLLM

Solo SDK:

pip install litellm

Con soporte para Proxy:

pip install "litellm[proxy]"

Paso 2 — Prueba mínima con el SDK de Python

Crea minimal_apimaster_test.py:

import litellm

API_KEY = "tu clave de APIMaster"

response = litellm.completion(
    model="openai/claude-sonnet-4-6",
    api_base="https://apimaster.ai/v1",
    api_key=API_KEY,
    messages=[
        {"role": "user", "content": "Di hola en una oración corta."},
    ],
    max_tokens=64,
)

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

O descarga el script de ejemplo.

python minimal_apimaster_test.py

Paso 3 — Configuración del Proxy de LiteLLM

Crea config.apimaster.yaml:

model_list:
  - model_name: apimaster-claude-sonnet
    litellm_params:
      model: openai/claude-sonnet-4-6
      api_base: https://apimaster.ai/v1
      api_key: os.environ/APIMASTER_API_KEY

general_settings:
  master_key: sk-local-test

O descarga la configuración de ejemplo.

Clave Propósito
APIMASTER_API_KEY Clave real de APIMaster — LiteLLM la usa para la conexión ascendente
master_key Clave de acceso al Proxy local — los clientes la usan

Paso 4 — Iniciar el Proxy de LiteLLM

export APIMASTER_API_KEY="tu clave de APIMaster"
litellm --config config.apimaster.yaml --port 4000

Si litellm no está en el PATH:

python -m litellm --config config.apimaster.yaml --port 4000

Paso 5 — Probar el Proxy local

curl http://localhost:4000/v1/chat/completions \
  -H "Authorization: Bearer sk-local-test" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "apimaster-claude-sonnet",
    "messages": [{"role": "user", "content": "Di hola en una oración corta."}],
    "max_tokens": 64
  }'

Paso 6 — Múltiples modelos

model_list:
  - model_name: apimaster-claude-sonnet
    litellm_params:
      model: openai/claude-sonnet-4-6
      api_base: https://apimaster.ai/v1
      api_key: os.environ/APIMASTER_API_KEY

  - model_name: apimaster-gpt
    litellm_params:
      model: openai/gpt-5.4
      api_base: https://apimaster.ai/v1
      api_key: os.environ/APIMASTER_API_KEY

general_settings:
  master_key: sk-local-test

Los clientes llaman a apimaster-gpt, no a openai/gpt-5.4.

Solución de problemas

401 Token inválido

La clave es incorrecta o está deshabilitada. Verifica:

curl https://apimaster.ai/v1/models \
  -H "Authorization: Bearer TU_CLAVE"

Modelo no encontrado

Usa el id del modelo del marketplace con el prefijo openai/:

model: openai/claude-sonnet-4-6

api_base incorrecto

Debe incluir /v1:

api_base: https://apimaster.ai/v1

Orden de verificación recomendado

  1. Script mínimo con el SDK de Python — valida la clave de APIMaster y el modelo.
  2. Inicia el Proxy de LiteLLM.
  3. Llama al Proxy local con JSON compatible con OpenAI.

Lista de verificación

  • Instalado litellm (litellm[proxy] para Proxy)
  • SDK: openai/<id del modelo> + api_base=https://apimaster.ai/v1
  • Proxy: APIMASTER_API_KEY y master_key configurados por separado
  • La prueba con SDK o Proxy devuelve una respuesta

Ver también