Skip to content

ccproxy.utils.model_mapping

ccproxy.utils.model_mapping

Unified model mapping utilities for OpenAI and Claude models.

This module provides a single source of truth for all model mappings, consolidating OpenAI→Claude mappings and Claude alias resolution.

map_model_to_claude 

map_model_to_claude(model_name)

Map any model name to its canonical Claude model name.

This function handles: - OpenAI model names → Claude equivalents - Claude aliases → canonical Claude names - Pattern matching for versioned models - Pass-through for unknown models

Parameters:

Name Type Description Default
model_name str

Model identifier (OpenAI, Claude, or alias)

 required

Returns:

Type Description
str

Canonical Claude model identifier
Source code in ccproxy/utils/model_mapping.py 
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
def map_model_to_claude(model_name: str) -> str:
    """Map any model name to its canonical Claude model name.

    This function handles:
    - OpenAI model names → Claude equivalents
    - Claude aliases → canonical Claude names
    - Pattern matching for versioned models
    - Pass-through for unknown models

    Args:
        model_name: Model identifier (OpenAI, Claude, or alias)

    Returns:
        Canonical Claude model identifier
    """
    # Direct mapping first (handles both OpenAI and Claude aliases)
    claude_model = MODEL_MAPPING.get(model_name)
    if claude_model:
        return claude_model

    # Pattern matching for versioned OpenAI models
    if model_name.startswith("gpt-4o-mini"):
        return "claude-3-5-haiku-latest"
    elif model_name.startswith("gpt-4o") or model_name.startswith("gpt-4"):
        return "claude-3-7-sonnet-20250219"
    elif model_name.startswith("gpt-3.5"):
        return "claude-3-5-haiku-latest"
    elif (
        model_name.startswith("o1")
        or model_name.startswith("gpt-5")
        or model_name.startswith("o3")
        or model_name.startswith("gpt")
    ):
        return "claude-sonnet-4-20250514"

    # If it's already a Claude model, pass through unchanged
    if model_name.startswith("claude-"):
        return model_name

    # For unknown models, pass through unchanged
    return model_name

get_openai_to_claude_mapping 

get_openai_to_claude_mapping()

Get mapping of OpenAI models to Claude models.

Returns:

Type Description
dict[str, str]

Dictionary mapping OpenAI model names to Claude model names
Source code in ccproxy/utils/model_mapping.py 
100
101
102
103
104
105
106
def get_openai_to_claude_mapping() -> dict[str, str]:
    """Get mapping of OpenAI models to Claude models.

    Returns:
        Dictionary mapping OpenAI model names to Claude model names
    """
    return {k: v for k, v in MODEL_MAPPING.items() if not k.startswith("claude-")}

get_claude_aliases_mapping 

get_claude_aliases_mapping()

Get mapping of Claude aliases to canonical Claude names.

Returns:

Type Description
dict[str, str]

Dictionary mapping Claude aliases to canonical model names
Source code in ccproxy/utils/model_mapping.py 
109
110
111
112
113
114
115
def get_claude_aliases_mapping() -> dict[str, str]:
    """Get mapping of Claude aliases to canonical Claude names.

    Returns:
        Dictionary mapping Claude aliases to canonical model names
    """
    return {k: v for k, v in MODEL_MAPPING.items() if k.startswith("claude-")}

get_supported_claude_models 

get_supported_claude_models()

Get list of supported canonical Claude models.

Returns:

Type Description
list[str]

Sorted list of unique canonical Claude model names
Source code in ccproxy/utils/model_mapping.py 
118
119
120
121
122
123
124
def get_supported_claude_models() -> list[str]:
    """Get list of supported canonical Claude models.

    Returns:
        Sorted list of unique canonical Claude model names
    """
    return sorted(set(MODEL_MAPPING.values()))

is_openai_model 

is_openai_model(model_name)

Check if a model name is an OpenAI model.

Parameters:

Name Type Description Default
model_name str

Model identifier to check

 required

Returns:

Type Description
bool

True if the model is an OpenAI model, False otherwise
Source code in ccproxy/utils/model_mapping.py 
127
128
129
130
131
132
133
134
135
136
137
138
139
def is_openai_model(model_name: str) -> bool:
    """Check if a model name is an OpenAI model.

    Args:
        model_name: Model identifier to check

    Returns:
        True if the model is an OpenAI model, False otherwise
    """
    return (
        model_name.startswith(("gpt-", "o1", "o3", "text-davinci"))
        or model_name in get_openai_to_claude_mapping()
    )

is_claude_model 

is_claude_model(model_name)

Check if a model name is a Claude model (canonical or alias).

Parameters:

Name Type Description Default
model_name str

Model identifier to check

 required

Returns:

Type Description
bool

True if the model is a Claude model, False otherwise
Source code in ccproxy/utils/model_mapping.py 
142
143
144
145
146
147
148
149
150
151
152
153
def is_claude_model(model_name: str) -> bool:
    """Check if a model name is a Claude model (canonical or alias).

    Args:
        model_name: Model identifier to check

    Returns:
        True if the model is a Claude model, False otherwise
    """
    return (
        model_name.startswith("claude-") or model_name in get_claude_aliases_mapping()
    )

map_openai_model_to_claude 

map_openai_model_to_claude(openai_model)

Legacy alias for map_model_to_claude().

Parameters:

Name Type Description Default
openai_model str

OpenAI model identifier

 required

Returns:

Type Description
str

Claude model identifier
Source code in ccproxy/utils/model_mapping.py 
162
163
164
165
166
167
168
169
170
171
def map_openai_model_to_claude(openai_model: str) -> str:
    """Legacy alias for map_model_to_claude().

    Args:
        openai_model: OpenAI model identifier

    Returns:
        Claude model identifier
    """
    return map_model_to_claude(openai_model)

get_canonical_model_name 

get_canonical_model_name(model_name)

Legacy alias for map_model_to_claude().

Parameters:

Name Type Description Default
model_name str

Model name (possibly an alias)

 required

Returns:

Type Description
str

Canonical model name
Source code in ccproxy/utils/model_mapping.py 
174
175
176
177
178
179
180
181
182
183
def get_canonical_model_name(model_name: str) -> str:
    """Legacy alias for map_model_to_claude().

    Args:
        model_name: Model name (possibly an alias)

    Returns:
        Canonical model name
    """
    return map_model_to_claude(model_name)