fastapi · YuriiMotov · Jan 28, 2026 · Jan 28, 2026 · Feb 20, 2026 · Feb 20, 2026
diff --git a/sqlmodel/main.py b/sqlmodel/main.py
@@ -3,6 +3,7 @@
 import builtins
 import ipaddress
 import uuid
+import warnings
 from collections.abc import Callable, Mapping, Sequence, Set
 from dataclasses import dataclass
 from datetime import date, datetime, time, timedelta
@@ -239,6 +240,7 @@ def Field(
     *,
     default_factory: NoArgAnyCallable | None = None,
     alias: str | None = None,
+    alias_priority: int | None = None,
     validation_alias: str | None = None,
     serialization_alias: str | None = None,
     title: str | None = None,
@@ -282,6 +284,7 @@ def Field(
     *,
     default_factory: NoArgAnyCallable | None = None,
     alias: str | None = None,
+    alias_priority: int | None = None,
     validation_alias: str | None = None,
     serialization_alias: str | None = None,
     title: str | None = None,
@@ -334,6 +337,7 @@ def Field(
     *,
     default_factory: NoArgAnyCallable | None = None,
     alias: str | None = None,
+    alias_priority: int | None = None,
     validation_alias: str | None = None,
     serialization_alias: str | None = None,
     title: str | None = None,
@@ -367,6 +371,7 @@ def Field(
     *,
     default_factory: NoArgAnyCallable | None = None,
     alias: str | None = None,
+    alias_priority: int | None = None,
     validation_alias: str | None = None,
     serialization_alias: str | None = None,
     title: str | None = None,
@@ -403,11 +408,21 @@ def Field(
     schema_extra: dict[str, Any] | None = None,
 ) -> Any:
     current_schema_extra = schema_extra or {}
+
+    for param_name in ("alias_priority",):
+        if param_name in current_schema_extra:
+            msg = f"Pass `{param_name}` parameter directly to Field instead of passing it via `schema_extra`"
+            warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
     # Extract possible alias settings from schema_extra so we can control precedence
     schema_validation_alias = current_schema_extra.pop("validation_alias", None)
     schema_serialization_alias = current_schema_extra.pop("serialization_alias", None)
+    current_alias_priority = alias_priority or current_schema_extra.pop(
+        "alias_priority", None
+    )
     field_info_kwargs = {
         "alias": alias,
+        "alias_priority": current_alias_priority,
         "title": title,
         "description": description,
         "exclude": exclude,

diff --git a/tests/test_pydantic/test_field.py b/tests/test_pydantic/test_field.py
@@ -2,7 +2,7 @@
 from typing import Literal
 
 import pytest
-from pydantic import ValidationError
+from pydantic import ConfigDict, ValidationError
 from sqlmodel import Field, SQLModel
 
 
@@ -54,3 +54,57 @@ class Model(SQLModel):
 
     instance = Model(id=123, foo="bar")
     assert "foo=" not in repr(instance)
+
+
+def test_alias_priority_1():
+    def to_camel(string: str) -> str:
+        return "".join(word.capitalize() for word in string.split("_"))
+
+    class Model(SQLModel):
+        model_config = ConfigDict(alias_generator=to_camel)
+
+        field: str = Field(alias="field_alias", alias_priority=1)
+
+    m = Model.model_validate({"Field": "value1"})
+    assert m.field == "value1"
+
+    with pytest.raises(ValidationError):
+        Model.model_validate({"field_alias": "value1"})
+
+
+@pytest.mark.parametrize("alias_priority", [None, 2])
+def test_alias_priority_2(alias_priority: int | None):
+    def to_camel(string: str) -> str:
+        return "".join(word.capitalize() for word in string.split("_"))
+
+    class Model(SQLModel):
+        model_config = ConfigDict(alias_generator=to_camel)
+
+        field: str = Field(alias="field_alias", alias_priority=alias_priority)
+
+    m = Model.model_validate({"field_alias": "value1"})
+    assert m.field == "value1"
+
+    with pytest.raises(ValidationError):
+        Model.model_validate({"Field": "value1"})
+
+
+def test_alias_priority_via_schema_extra():  # Current workaround. Remove after some time
+    def to_camel(string: str) -> str:
+        return "".join(word.capitalize() for word in string.split("_"))
+
+    with pytest.warns(
+        DeprecationWarning,
+        match="Pass `alias_priority` parameter directly to Field instead of passing it via `schema_extra`",
+    ):
+
+        class Model(SQLModel):
+            model_config = ConfigDict(alias_generator=to_camel)
+
+            field: str = Field(alias="field_alias", schema_extra={"alias_priority": 2})
+
+    m = Model.model_validate({"field_alias": "value1"})
+    assert m.field == "value1"
+
+    with pytest.raises(ValidationError):
+        Model.model_validate({"Field": "value1"})