Skip to main content
AIHubMix Skill is a local extension for AI coding agents. After installation, you can use natural language in Codex, Claude Code, Cursor, Cline, and other Skills-capable agents to integrate AIHubMix, query models, choose by capability, generate examples, and troubleshoot errors. This Skill does not include a fixed model list. Instead, it reads models, pricing, context windows, protocol contracts, and other real-time information from official AIHubMix APIs when needed, helping the agent avoid stale memory.

​
Use Cases

​
Prerequisites

  • Install at least one Skills-capable AI Agent, such as Codex, Claude Code, Cursor, Cline, Gemini CLI, or OpenCode.
  • Make sure Python 3.8 or later is available locally.
  • For real model calls, prepare an AIHubMix API Key.
  • To query balance, Key lists, or models callable by the current account, install and log in to the official aihubmix CLI.

​
Installation

​
Option 1: Let the Agent Install It

Give this instruction to your current AI Agent:

​
Option 2: Manual Installation

Different agents may use different Skills directories. If your tool uses a shared directory, check that agent’s Skills documentation first, or let the agent decide the installation location.

​
Optional: Install AIHubMix CLI

The AiHubMixAPI script can read public model and protocol information. Account balance, Key management, and models actually callable by the current account require the official CLI after login.
After installation, run:

​
How to Use

After installation, you usually do not need to remember commands. Describe the task directly in your agent:
If the agent does not trigger the Skill automatically, call it explicitly:

​
Command Line Usage

You can also run the script directly from the Skill directory:
For Chinese output, append --lang zh or set:

​
Capability Quick Reference

​
FAQ

​
The Agent Does Not Trigger the Skill Automatically

Different agents have different Skill-triggering strategies. You can first call /AiHubMixAPI explicitly, or describe the task more directly with keywords such as “AIHubMix”, “model”, “Base URL”, “API Key”, or “error code”.

​
A Model Appears in the Public List, but My Key Cannot Call It

The public model list only means the model exists on the platform. It does not guarantee that the current account has permission or balance to call it. Use aihubmix models list or candidates --mine to check the account’s real callable range, then use doctor --model <model-id> for a real verification.

​
When Do I Need the aihubmix CLI

You do not need it for public information. You need to install and log in to the CLI for account-related capabilities such as balance, Key management, callable models, and --mine filtering.

​
Will the API Key Be Exposed

The Skill script redacts secrets. Still, avoid writing real Keys into repository files, issues, PR descriptions, or chat logs. Use environment variables for local debugging.