Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

A CLI da AiHubMix é um conjunto de scripts utilitários que permite gerenciar suas chaves de API da AiHubMix, consultar informações da conta e usar serviços de IA sem precisar passar por uma interface web. Essencialmente, ela encapsula chamadas de API (usando curl ou requests do Python) para conveniência via linha de comando.

​
Pré-requisitos

Antes de usar a CLI da AiHubMix, você precisa:
  1. Uma conta AIHubMix
  2. Gerar um Access Token clicando em “Generate System Access Token” na página de Configurações da AIHubMix;
  3. Instalar as dependências necessárias do Python:
pip install -U requests openai
O script aihubmix_cli.py pode ser baixado aqui

​
Visão Geral dos Recursos

A CLI da AIHubMix oferece as seguintes funcionalidades principais:

​
Visão Geral dos Endpoints da API

EndpointMétodo HTTPDescrição
/api/user/selfGETRecupera informações do usuário atual e saldo da conta
/api/token/GETRecupera uma lista de todas as chaves
/api/token/POSTCria uma nova chave de API
/api/token/PUTAtualiza uma chave de API existente
/api/token/{token_id}GETRecupera informações detalhadas de uma chave específica
/api/token/{token_id}DELETEExclui uma chave específica
/api/token/searchGETBusca chaves (use ?keyword=search_term)
/api/user/tokenGETRecupera chaves do usuário
/api/user/available_modelsGETRecupera lista de modelos disponíveis para o usuário atual

​
Recuperar Informações de Saldo

# Using curl to retrieve balance, balance is quota / 500000
curl -X GET "https://aihubmix.com/api/user/self" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Gerenciamento de Chaves

​
Criar Nova Chave

curl -X POST "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New Key Name",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "subnet": ""
  }'

​
Obter Lista de Chaves

curl -X GET "https://aihubmix.com/api/token/?num=20" \ # Adjust num parameter to change the number of output data.
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Buscar Chave

curl -X GET "https://aihubmix.com/api/token/search?keyword=search_term" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Atualizar Chave

curl -X PUT "https://aihubmix.com/api/token/" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "Key_ID",
    "name": "New Name",
    "expired_time": 86400,
    "remain_quota": 100000,
    "status": 1
  }'

​
Excluir Chave

curl -X DELETE "https://aihubmix.com/api/token/Key_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Obter Chave do Usuário

curl -X GET "https://aihubmix.com/api/user/token" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Gerenciamento de Modelos

​
Obter Modelos Disponíveis para o Usuário

curl -X GET "https://aihubmix.com/api/user/available_models" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Saída em Formato JSON

Todos os comandos da CLI suportam a saída de resultados em formato JSON, facilitando o processamento programático: 
python aihubmix_cli.py --url "https://aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance --json

​
Solução de Problemas

Se encontrar problemas, você pode tentar as seguintes soluções:
  1. Problemas de Conexão: Se o domínio principal falhar ao conectar, tente usar um domínio alternativo: 
    python aihubmix_cli.py --url "https://api.aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance
  2. Access Token Inválido: Certifique-se de que o access token fornecido é uma chave válida obtida no site da AIHubMix. O formato do access token geralmente é como fd***.
  3. Permissões Insuficientes: Algumas operações podem exigir permissões específicas, então certifique-se de que sua conta tem permissões adequadas.
  4. Falha na Requisição: Verifique sua conexão de rede ou tente novamente mais tarde.

​
Observações

  • O access token é diferente da chave de API regular usada para acessar modelos de IA.
  • Cada usuário tem seu próprio access token do sistema, e o nível de acesso é determinado pelo papel do usuário (usuário comum, administrador ou usuário root).
Última atualização: 2026-06-01