Ratio Settings

Ratio settings are a core configuration of the NewAPI billing system, allowing flexible control over the billing standards for various models and user groups by setting different ratios.

Ratio System Overview

NewAPI uses a three-tier ratio system to calculate user quota consumption:

1. Model Ratio - Defines the base billing multiplier for different AI models
2. Completion Ratio - Applies additional billing adjustments to output tokens
3. Group Ratio - Sets differentiated billing multipliers for different user groups

Relationship Between Quota and Ratios

In the New API system, ratios are key parameters for calculating quota consumption. Quota is an internal billing unit of the system, and all API calls are ultimately converted into quota points for deduction.

Quota Unit Conversion:

• 1 USD = 500,000 quota points
• Quota points are the basic unit for internal system billing
• User balances and consumption records are based on quota points

Quota Calculation Formulas

Pay-as-you-go Models (Based on Token Consumption)

配额消耗 = (输入token数 + 输出token数 × 补全倍率) × 模型倍率 × 分组倍率

Per-call Billing Models (Fixed Price)

配额消耗 = 模型固定价格 × 分组倍率 × 配额单位(500,000)

Audio Models (Special handling, automatically processed internally by NewAPI)

配额消耗 = (文本输入token + 文本输出token × 补全倍率 + 音频输入token × 音频倍率 + 音频输出token × 音频倍率 × 音频补全倍率) × 模型倍率 × 分组倍率

Pre-consumption and Post-consumption Mechanism

New API adopts a dual billing mechanism of pre-consumption and post-consumption:

1. Pre-consumption phase: Before an API call, quota consumption is calculated based on estimated token count and pre-deducted.
2. Post-consumption phase: After an API call is completed, quota consumption is recalculated based on the actual token count.
3. Difference adjustment: If the actual consumption differs from the pre-consumption, the system automatically adjusts the user's quota balance.

预消费配额 = 预估token数 × 模型倍率 × 分组倍率
实际配额 = 实际token数 × 模型倍率 × 分组倍率
配额调整 = 实际配额 - 预消费配额

Model Ratio Settings

Model ratios define the base billing multipliers for different AI models, and the system pre-sets default ratios for various models.

Common Model Ratio Examples

Ratio Meaning Explanation:

• Model Ratio: A multiplier relative to the base billing unit, reflecting cost differences between models
• Completion Ratio: The billing multiplier for output tokens relative to input tokens, reflecting output cost differences
• Higher ratios consume more quota; lower ratios consume less quota

Setup Methods

1. JSON Format Setting: Directly edit the model ratio JSON configuration
2. Visual Editor: Set ratios via a graphical interface

Completion Ratio Settings

Completion ratios are used for additional billing of output tokens, primarily to balance the input and output cost differences across various models.

Default Completion Ratios

Setup Instructions

• Completion ratios primarily affect the billing of output tokens
• Setting to 1 means output token billing is the same as input token billing
• Greater than 1 means higher billing for output tokens, less than 1 means lower billing for output tokens

Group Ratio Settings

Group ratios allow setting differentiated billing multipliers for different user groups, enabling flexible pricing strategies.

Group Ratio Configuration

{
  "vip": 0.5,
  "premium": 0.8,
  "standard": 1.0,
  "trial": 2.0
}

Group Ratio Priority

1. User-specific Ratio: Personal ratio set for a specific user
2. Group Ratio: The ratio of the group the user belongs to
3. Default Ratio: System default ratio (usually 1.0)

Visual Ratio Settings

The visual editor provides an intuitive ratio management interface, supporting:

• Batch editing of model ratios
• Real-time preview of ratio configurations
• Conflict detection and prompts
• One-click synchronization of upstream ratios

Models Without Ratio Settings

For models without ratio settings, the system will:

1. Self-use mode: Use the default ratio of 37.5
2. Commercial mode: Prompt "Ratio or price not configured" error
3. Automatic detection: Display unconfigured models in the management interface

Upstream Ratio Synchronization

The system supports automatic synchronization of ratio settings from upstream channels:

• Automatically retrieve upstream model ratios
• Batch update local ratio configurations
• Stay synchronized with upstream prices
• Supports manual adjustment and override

Frequently Asked Questions

Q: How to set ratios for new models?

A: You can add new models via the visual editor or directly in the JSON configuration. It is recommended to set a conservative ratio first and adjust it based on actual usage.

Q: How do group ratios take effect?

A: Group ratios are multiplied by model ratios, ultimately affecting the calculation of user quota consumption. A user's effective ratio = Model Ratio × Group Ratio.

Q: What is the purpose of the completion ratio?

A: The completion ratio is mainly used to balance the cost differences between input and output tokens. For some models, the output cost is significantly higher than the input cost, requiring adjustment via the completion ratio.

Q: How to batch set ratios for similar models?

A: You can perform batch operations through the visual editor, or directly add ratio settings for similar models in bulk within the JSON configuration.

Quota Calculation Examples

Example 1: GPT-4 Standard User Conversation

Scenario Parameters:

• Input tokens: 1,000
• Output tokens: 500
• Model Ratio: 15
• Completion Ratio: 2
• Group Ratio: 1.0 (Standard user)

Calculation Process:

配额消耗 = (1,000 + 500 × 2) × 15 × 1.0
         = (1,000 + 1,000) × 15
         = 2,000 × 15
         = 30,000 配额点数

Equivalent USD Cost: 30,000 ÷ 500,000 = $0.06

Example 2: GPT-3.5 VIP User Conversation

Scenario Parameters:

• Input tokens: 2,000
• Output tokens: 1,000
• Model Ratio: 0.25
• Completion Ratio: 1.33
• Group Ratio: 0.5 (VIP user 50% discount)

Calculation Process:

配额消耗 = (2,000 + 1,000 × 1.33) × 0.25 × 0.5
         = (2,000 + 1,330) × 0.125
         = 3,330 × 0.125
         = 416.25 配额点数

Equivalent USD Cost: 416.25 ÷ 500,000 = $0.00083

Example 3: Per-call Billing Model (e.g., Midjourney)

Scenario Parameters:

• Model Fixed Price: $0.02
• Group Ratio: 1.0 (Standard user)
• Quota Unit: 500,000

Calculation Process:

配额消耗 = 0.02 × 1.0 × 500,000
         = 10,000 配额点数

Equivalent USD Cost: 10,000 ÷ 500,000 = $0.02

For more billing rules, please refer to Frequently Asked Questions