LiteLLM + APIMaster.ai

Conecte a API compatível com OpenAI do APIMaster.ai via SDK Python do LiteLLM ou Proxy LiteLLM.

LiteLLM fornece um SDK unificado de LLM e um servidor Proxy local. O APIMaster.ai expõe uma API compatível com OpenAI — use o formato openai/<id do modelo> e defina api_base.

Obtenha primeiro uma Chave de API. Copie o id do modelo exato do marketplace.

URL base:

https://apimaster.ai/v1

Formato do nome do modelo no LiteLLM:

openai/<id do modelo APIMaster>

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

Pré-requisitos

Python 3.10+ (3.11+ recomendado).
Uma chave de API do APIMaster a partir do console.
Um id do modelo alvo do marketplace.

Passo 1 — Instalar o LiteLLM

Apenas SDK:

pip install litellm

Com suporte a Proxy:

pip install "litellm[proxy]"

Passo 2 — Teste mínimo com SDK Python

Crie 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)

Ou baixe o script de exemplo.

python minimal_apimaster_test.py

Passo 3 — Configuração do Proxy LiteLLM

Crie 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

Ou baixe o exemplo de configuração.

Chave	Finalidade
`APIMASTER_API_KEY`	Chave real do APIMaster — o LiteLLM a usa para o upstream
`master_key`	Chave de acesso local ao Proxy — os clientes usam esta

Passo 4 — Iniciar o Proxy LiteLLM

export APIMASTER_API_KEY="sua chave APIMaster"
litellm --config config.apimaster.yaml --port 4000

Se litellm não estiver no PATH:

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

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

Passo 6 — Múltiplos 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

Os clientes chamam apimaster-gpt, não openai/gpt-5.4.

Solução de problemas

401 Token inválido

A chave está incorreta ou desabilitada. Verifique:

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

Modelo não encontrado

Use o id do modelo do marketplace com o prefixo openai/:

model: openai/claude-sonnet-4-6

api_base incorreta

Deve incluir /v1:

api_base: https://apimaster.ai/v1