README

English | 中文

A Symfony bundle for integrating with DeepSeek API, providing API key management, model listing, and balance checking capabilities.

Features

Multiple API key management with automatic rotation
List available models for each API key
Check account balance in multiple currencies
Validate API keys
Command-line tools for API interaction

Installation

composer require tourze/deep-seek-api-bundle

Configuration

Configure your API keys in your Symfony configuration:

# config/packages/deep_seek_api.yaml
deep_seek_api:
    api_keys:
        - 'your-api-key-1'
        - 'your-api-key-2'

Commands

Analyze Balance Trends

Analyze balance changes and usage patterns over time.

# Analyze balance for the last 7 days
bin/console deep-seek:analyze-balance

# Analyze balance for specific number of days
bin/console deep-seek:analyze-balance --days=30

# Analyze with specific time interval (hourly, daily, weekly)
bin/console deep-seek:analyze-balance --interval=daily

# Display in specific currency
bin/console deep-seek:analyze-balance --currency=CNY

# Show alerts for significant changes
bin/console deep-seek:analyze-balance --show-alerts

Manage API Keys

Manage DeepSeek API keys including listing, adding, and deactivating.

# List all API keys
bin/console deep-seek:api-key list

# Add a new API key
bin/console deep-seek:api-key add sk-your-api-key --name="Production Key"

# Deactivate an API key
bin/console deep-seek:api-key deactivate sk-your-api-key

# Activate an API key
bin/console deep-seek:api-key activate sk-your-api-key

# Show API key details
bin/console deep-seek:api-key show sk-your-api-key

Check Balance

Check the current balance for all API keys or a specific key.

# Check balance for all keys
bin/console deepseek:balance:check

# Check balance with detailed output
bin/console deepseek:balance:check --verbose

List Models

List all available models from DeepSeek API.

# List models for all keys
bin/console deepseek:models:list

# List models in JSON format
bin/console deepseek:models:list --json

Validate API Key

Validate whether API keys are working correctly.

# Validate all API keys
bin/console deepseek:api-key:validate --all-keys

# Validate specific API key
bin/console deepseek:api-key:validate --key=sk-your-api-key

Sync Data

Synchronize models and balance data from DeepSeek API.

# Sync all data (models and balances)
bin/console deep-seek:sync-data

# Sync only models
bin/console deep-seek:sync-data --models-only

# Sync only balances
bin/console deep-seek:sync-data --balances-only

# Force sync even if recently synced
bin/console deep-seek:sync-data --force

Usage in Code

Using DeepSeekService

use Tourze\DeepSeekApiBundle\Service\DeepSeekService;

class MyService
{
    public function __construct(
        private DeepSeekService $deepSeekService
    ) {}

    public function example(): void
    {
        // List models
        $models = $this->deepSeekService->listModels();
        
        // Check balance
        $balance = $this->deepSeekService->getBalance();
        
        // Validate API key
        $isValid = $this->deepSeekService->validateApiKey('your-api-key');
    }
}

Managing API Keys

use Tourze\DeepSeekApiBundle\Service\ApiKeyManager;

class MyKeyManager
{
    public function __construct(
        private ApiKeyManager $apiKeyManager
    ) {}

    public function example(): void
    {
        // Add a new API key
        $this->apiKeyManager->addApiKey('new-api-key');
        
        // Rotate to next key
        $this->apiKeyManager->rotateToNextKey();
        
        // Get current key
        $currentKey = $this->apiKeyManager->getCurrentKey();
        
        // Mark key as invalid
        $this->apiKeyManager->markKeyAsInvalid('bad-key');
    }
}

tourze / deep-seek-api-bundle

Maintainers

Details