AiHubMix CLI는 웹 인터페이스에 액세스할 필요 없이 AiHubMix API 키를 관리하고, 계정 정보를 쿼리하고, AI 서비스를 사용할 수 있게 해주는 유틸리티 관리 스크립트 모음입니다. 기본적으로 명령줄에서 더 쉽게 사용할 수 있도록 API 호출(curl 또는 Python 요청)을 래핑합니다.

​
전제 조건

AiHubMix CLI를 사용하기 전에 다음이 필요합니다:

  1. AiHubMix 계정
  2. AiHubMix 설정 페이지에서 “시스템 액세스 토큰 생성”을 클릭하여 생성된 액세스 토큰
  3. 필요한 Python 종속성:
pip install -U requests openai

aihubmix_cli.py 스크립트는 여기에서 다운로드할 수 있습니다.

​
모델

​
기능 목록

AiHubMix CLI는 다음과 같은 주요 기능을 제공합니다:

​
API 엔드포인트 개요

엔드포인트HTTP 메서드설명
/api/user/selfGET현재 사용자 정보 및 계정 잔액 가져오기
/api/token/GET모든 API 키 목록 가져오기
/api/token/POST새 API 키 만들기
/api/token/PUT기존 API 키 업데이트
/api/token/{token_id}GET특정 API 키의 세부 정보 가져오기
/api/token/{token_id}DELETE특정 API 키 삭제
/api/token/searchGETAPI 키 검색 ( ?keyword=search_term 사용)
/api/user/tokenGET사용자 API 키 가져오기
/api/modelsGET사용 가능한 모든 모델 목록 가져오기
/api/user/available_modelsGET현재 사용자가 사용할 수 있는 모델 목록 가져오기

​
계정 관리

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

​
API 키 관리

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

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

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

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

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

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

​
모델 관리

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

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

​
JSON 형식 출력

모든 CLI 명령은 프로그래밍 방식으로 처리할 수 있도록 결과를 JSON 형식으로 출력하는 것을 지원합니다:

python aihubmix_cli.py --url "https://aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance --json

​
문제 해결

문제가 발생하면 다음 해결 방법을 시도해 보십시오:

  1. 연결 문제: 주 도메인 연결이 실패하면 백업 도메인을 사용해 보십시오:

    python aihubmix_cli.py --url "https://api.aihubmix.com" --token "YOUR_ACCESS_TOKEN" --action get_balance

  2. 잘못된 액세스 토큰: 제공된 액세스 토큰이 AiHubMix 웹사이트에서 얻은 유효한 키인지 확인하십시오. 액세스 토큰은 일반적으로 fd***와 같은 형식을 가집니다.

  3. 권한 부족: 일부 작업에는 특정 권한이 필요할 수 있습니다. 계정에 충분한 권한이 있는지 확인하십시오.

  4. 요청 실패: 네트워크 연결을 확인하거나 나중에 다시 시도하십시오.

​
참고

  • 액세스 토큰은 AI 모델에 액세스하는 데 사용되는 일반 API 키와 다릅니다.
  • 각 사용자는 고유한 시스템 액세스 토큰을 가지고 있으며, 액세스 수준은 사용자 역할(일반 사용자, 관리자 또는 루트 사용자)에 따라 결정됩니다.