LiteLLM + APIMaster.ai

Connetti l'API compatibile con OpenAI di APIMaster.ai tramite LiteLLM Python SDK o LiteLLM Proxy.

LiteLLM fornisce un SDK LLM unificato e un server Proxy locale. APIMaster.ai espone un'API compatibile con OpenAI — usa il formato openai/<model id> e imposta api_base.

Ottieni prima una API Key. Copia l'esatto model id dal marketplace.

URL di base:

https://apimaster.ai/v1

Formato del nome del modello LiteLLM:

openai/<APIMaster model id>

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

Prerequisiti

Python 3.10+ (3.11+ consigliato).
Una API Key APIMaster dalla console.
Un model id target dal marketplace.

Passo 1 — Installa LiteLLM

Solo SDK:

pip install litellm

Con supporto Proxy:

pip install "litellm[proxy]"

Passo 2 — Test minimo con Python SDK

Crea minimal_apimaster_test.py:

import litellm

API_KEY = "your APIMaster key"

response = litellm.completion(
    model="openai/claude-sonnet-4-6",
    api_base="https://apimaster.ai/v1",
    api_key=API_KEY,
    messages=[
        {"role": "user", "content": "Say hi in one short sentence."},
    ],
    max_tokens=64,
)

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

Oppure scarica lo script di esempio.

python minimal_apimaster_test.py

Passo 3 — Configurazione del Proxy 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

Oppure scarica la configurazione di esempio.

Chiave	Scopo
`APIMASTER_API_KEY`	Chiave APIMaster reale — LiteLLM la utilizza upstream
`master_key`	Chiave di accesso al Proxy locale — i client la utilizzano

Passo 4 — Avvia il Proxy LiteLLM

export APIMASTER_API_KEY="your APIMaster key"
litellm --config config.apimaster.yaml --port 4000

Se litellm non è nel PATH:

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

Passo 5 — Test del Proxy locale

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": "Say hi in one short sentence."}],
    "max_tokens": 64
  }'

Passo 6 — Modelli multipli

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

I client chiamano apimaster-gpt, non openai/gpt-5.4.

Risoluzione dei problemi

401 Token non valido

La chiave è sbagliata o disabilitata. Verifica:

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

Modello non trovato

Usa il model id del marketplace con il prefisso openai/:

model: openai/claude-sonnet-4-6

api_base errato

Deve includere /v1:

api_base: https://apimaster.ai/v1