AI POOL
Guide
Official Website
Guide
Official Website

Quick Start

This guide will help you quickly get started with AI-POOL, from registering an account to creating your first API token.

Register an Account

  1. Visit the AI-POOL platform
  2. Click the "Register" button in the upper right corner
  3. Fill in the registration information:
    • Phone number
    • Password (strong password recommended)
  4. Complete registration and log in

Account Recharge

Before using AI model services, you need to recharge your account first.

  1. After logging in, click the "Wallet" or "Recharge" button in the navigation bar
  2. Select recharge amount:
    • Quick selection: ¥10, ¥50, ¥100, ¥500
    • Custom amount: ¥10 - ¥10,000 (integers only)
  3. Click "Recharge Now" to generate a payment QR code
  4. Scan with Alipay or WeChat to pay
  5. After successful payment, the balance will be credited in real-time

💡 Tip: For first-time use, it's recommended to recharge a small amount for testing.

Create API Token

API tokens are credentials for calling AI-POOL services. You need to create at least one token to start using the service.

Step 1: Enter Token Management Page

  1. Log in to the AI-POOL platform
  2. Click "Token Management" in the left navigation bar
  3. Click the "Create Token" button in the upper right corner

Step 2: Configure Token Information

In the create token dialog, fill in the following information:

Basic Information

  • Token Name: Set an easily identifiable name for the token (e.g., Production Environment, Test Environment, Project A, etc.)
  • Token Description (optional): Add detailed description for easier management

Quota Settings

  • Usage Quota: Set the maximum available quota for this token
    • Leave blank for unlimited
    • Set a specific amount to prevent overspending

Validity Period Settings

  • Expiration Time (optional): Set the validity period of the token
    • Leave blank for permanent validity
    • Recommended to set a shorter validity period for test tokens

Model Permissions

  • Available Models: Select which AI models this token can access
    • Can select one or multiple models
    • Recommended to select based on actual needs to avoid unnecessary permissions

Step 3: Save and Get Token

  1. After confirming the information is correct, click the "Create" button
  2. After successful token creation, the complete API Key will be displayed
  3. Important: Please copy and save the API Key immediately. For security reasons, you will not be able to view the complete key again later
  4. Click the "Copy" button to copy the API Key to clipboard

Step 4: Test Token

After creating the token, you can start using it immediately. Here's a simple call example:

curl https://ai-gate.haozcloud.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [
      {
        "role": "user",
        "content": "Hello, AI-POOL!"
      }
    ]
  }'

Replace YOUR_API_KEY with the API Key you just created.

Token Management

View Token List

On the token management page, you can see all created tokens, including:

  • Token name and description
  • Creation time
  • Expiration time
  • Usage quota and remaining quota
  • Status (enabled/disabled)
  • Number of associated models

Edit Token

  1. Find the token you need to edit in the token list
  2. Click the "Edit" button in the action column
  3. Modify token information (name, description, quota, expiration time, model permissions)
  4. Click "Save" to confirm changes

⚠️ Note: Editing a token does not change the API Key itself, the original API Key remains valid.

Enable/Disable Token

If you need to temporarily disable a token:

  1. Find the target token in the token list
  2. Click the status switch to set the token to "Disabled"
  3. After disabling, API calls using this token will be rejected
  4. To restore, click the switch again to enable

Delete Token

If you no longer need a token:

  1. Find the target token in the token list
  2. Click the "Delete" button in the action column
  3. Confirm the deletion operation
  4. After deletion, the API Key will be immediately invalidated

⚠️ Warning: Deleting a token is irreversible. Please ensure no applications are using this token.

Monitor Usage

After creating tokens, it's recommended to regularly check usage:

  1. View overall usage statistics in "Personal Center"
  2. View quota consumption for each token in "Token Management"
  3. View detailed consumption records in "Balance Flow"
  4. Track each API call in "Audit Log"

Next Steps

Now that you have successfully created your first API token, you can:

Best Practices

Token Naming Convention

  • Use meaningful names, such as "Production-Main Service" "Test Environment"
  • Create separate tokens for different projects or environments
  • Add detailed description information

Security Recommendations

  • Do not hardcode API Keys in code
  • Use environment variables or configuration files to store API Keys
  • Regularly rotate API Keys in production environments
  • Set lower quota limits for test tokens
  • Delete tokens that are no longer in use promptly

Quota Management

  • Set reasonable quota limits for each token
  • Regularly check token usage
  • Recharge promptly when balance is insufficient
  • Use quota limits to prevent accidental overspending

Permission Control

  • Follow the principle of least privilege, only grant necessary model access permissions
  • Configure different model permissions for tokens with different purposes
  • Regularly review token permission configurations
ON THIS Page