Skip to content

API Reference

gi

Modules:

  • artifact

    Genshin Impact artifact models.

  • character

    Genshin Impact character models.

  • mw

    Miliastra Wonderland costume and item models.

  • new

    Genshin Impact new data model.

  • stygian

    Genshin Impact Stygian Onslaught models.

  • weapon

    Genshin Impact weapon models.

Classes:

Artifact pydantic-model

Represent a Genshin Impact artifact.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon

description pydantic-field

description: str

icon pydantic-field

icon: str

name pydantic-field

name: str

ArtifactSet pydantic-model

Represent a Genshin Impact artifact set.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon
  • __assign_set_effectsset_effect
  • __extract_names

icon pydantic-field

icon: str

id pydantic-field

id: int

name pydantic-field

name: str = ''

names pydantic-field

names: dict[Literal['en', 'ko', 'zh', 'ja'], str]

rarities pydantic-field

rarities: list[int]

set_effect pydantic-field

set_effect: ArtifactSetEffects

ArtifactSetDetail pydantic-model

Represent a Genshin Impact artifact set detail.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon
  • __assign_set_effectset_effect

icon pydantic-field

icon: str

id pydantic-field

id: int

parts pydantic-field

parts: dict[str, Artifact]

set_effect pydantic-field

ArtifactSetDetailSetEffects pydantic-model

Represent set effects of an artifact set detail.

Attributes:

Fields:

Validators:

  • __format_fields

four_piece pydantic-field

four_piece: SetEffect | None = None

two_piece pydantic-field

two_piece: SetEffect

ArtifactSetEffect pydantic-model

Represent an artifact set effect.

Attributes:

Fields:

Validators:

  • __format_fields
  • __transform_names

description pydantic-field

description: str = ''

descriptions pydantic-field

descriptions: dict[Literal['en', 'ko', 'zh', 'ja'], str]

name pydantic-field

name: str = ''

names pydantic-field

names: dict[Literal['en', 'ko', 'zh', 'ja'], str]

ArtifactSetEffects pydantic-model

Represent artifact set effects.

Attributes:

Fields:

Validators:

  • __format_fields

four_piece pydantic-field

four_piece: ArtifactSetEffect | None = None

two_piece pydantic-field

two_piece: ArtifactSetEffect

Character pydantic-model

Represent a Genshin Impact character.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon
  • __convert_rarityrarity
  • __convert_elementelement
  • __transform_names

description pydantic-field

description: str

element pydantic-field

element: GIElement | None = None

icon pydantic-field

icon: str

id pydantic-field

id: str

name pydantic-field

name: str = ''

names pydantic-field

names: dict[Literal['en', 'zh', 'ko', 'ja'], str]

rarity pydantic-field

rarity: Literal[4, 5]

CharacterConstellation pydantic-model

Represent a character's constellation.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon

description pydantic-field

description: str

icon pydantic-field

icon: str

name pydantic-field

name: str

parameters pydantic-field

parameters: list[float]

CharacterDetail pydantic-model

Represent a Genshin Impact character detail.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon
  • __convert_rarityrarity

base_atk pydantic-field

base_atk: float

base_def pydantic-field

base_def: float

base_hp pydantic-field

base_hp: float

constellations pydantic-field

constellations: list[CharacterConstellation]

crit_dmg pydantic-field

crit_dmg: float

crit_rate pydantic-field

crit_rate: float

description pydantic-field

description: str

gacha_art property

gacha_art: str

Get the character's gacha art URL.

icon pydantic-field

icon: str

info pydantic-field

name pydantic-field

name: str

passives pydantic-field

rarity pydantic-field

rarity: Literal[4, 5]

skills pydantic-field

stamina_recovery pydantic-field

stamina_recovery: float

stats_modifier pydantic-field

stats_modifier: CharacterStatsModifier

upgrade_materials pydantic-field

upgrade_materials: UpgradeMaterialInfos

CharacterInfo pydantic-model

Represent a character's information.

Attributes:

Fields:

Validators:

  • __format_fields
  • __handle_empty_namecardnamecard

namecard pydantic-field

namecard: Namecard | None = None

CharacterPassive pydantic-model

Represent a character's passive talent.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon

description pydantic-field

description: str

icon pydantic-field

icon: str

name pydantic-field

name: str

parameters pydantic-field

parameters: list[float]

unlock pydantic-field

unlock: int | list[int]

CharacterSkill pydantic-model

Represent a character's skill.

Attributes:

Fields:

Validators:

  • __format_fields

description pydantic-field

description: str

name pydantic-field

name: str

upgrade_info pydantic-field

upgrade_info: dict[str, SkillUpgradeInfo]

CharacterStatsModifier pydantic-model

Represent a character's stat modifiers.

Attributes:

Fields:

Validators:

  • __format_fields

ascension pydantic-field

ascension: list[dict[str, float]]

atk pydantic-field

atk: dict[str, float]

def_ pydantic-field

def_: dict[str, float]

hp pydantic-field

hp: dict[str, float]

prop_growth_curves pydantic-field

prop_growth_curves: list[FightPropGrowthCurve] | None = None

FightPropGrowthCurve pydantic-model

Represent a character's stat growth curve data.

Attributes:

Fields:

Validators:

  • __format_fields

growth_type pydantic-field

growth_type: str

stat_type pydantic-field

stat_type: str

MWCostume pydantic-model

Miliastra Wonderland costume

Fields:

Validators:

  • __format_fields
  • __convert_rarityrarity
  • __icon_urlicon

slots pydantic-field

slots: list[str]

MWCostumeSet pydantic-model

Miliastra Wonderland costume set

Fields:

Validators:

  • __format_fields
  • __convert_rarityrarity
  • __icon_urlicon

MWItem pydantic-model

Miliastra Wonderland item

Fields:

Validators:

  • __format_fields
  • __icon_urlicon

description pydantic-field

description: str

icon pydantic-field

icon: str | None

id pydantic-field

id: int

name pydantic-field

name: str

rarity pydantic-field

rarity: Literal[5, 4, 3, 2, 1] | None

sources pydantic-field

sources: list[str]

type pydantic-field

type: str

Namecard pydantic-model

Represent a character's namecard.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon

description pydantic-field

description: str

icon pydantic-field

icon: str

id pydantic-field

id: int

name pydantic-field

name: str

New pydantic-model

Represent new Genshin Impact data.

Attributes:

Fields:

Validators:

  • __format_fields

artifact_set_ids pydantic-field

artifact_set_ids: list[int]

character_ids pydantic-field

character_ids: list[str | int]

item_ids pydantic-field

item_ids: list[int]

monster_ids pydantic-field

monster_ids: list[int]

version pydantic-field

version: str

weapon_ids pydantic-field

weapon_ids: list[int]

SetEffect pydantic-model

Represent a set effect.

Attributes:

Fields:

Validators:

  • __format_fields

affix_id pydantic-field

affix_id: int

description pydantic-field

description: str

id pydantic-field

id: int

name pydantic-field

name: str

parameters pydantic-field

parameters: list[float]

SkillUpgradeInfo pydantic-model

Represent a character's skill upgrade information.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon
  • __remove_empty_attributesattributes

attributes pydantic-field

attributes: list[str]

icon pydantic-field

icon: str

level pydantic-field

level: int

parameters pydantic-field

parameters: list[float]

Stygian pydantic-model

A Stygian Onslaught entry.

Attributes:

Fields:

Validators:

  • __format_fields
  • __transform_names

beta_end_at pydantic-field

beta_end_at: datetime | None = None

beta_start_at pydantic-field

beta_start_at: datetime | None = None

id pydantic-field

id: int

live_end_at pydantic-field

live_end_at: datetime | None = None

live_start_at pydantic-field

live_start_at: datetime | None = None

name pydantic-field

name: str = ''

names pydantic-field

names: dict[Literal['en', 'zh', 'ko', 'ja'], str]

StygianDetail pydantic-model

Details of a Stygian Onslaught entry.

Attributes:

Fields:

Validators:

  • __format_fields
  • __process_levelslevels

end_at pydantic-field

end_at: datetime

id pydantic-field

id: int

levels pydantic-field

levels: dict[int, StygianLevel]

name pydantic-field

name: str

start_at pydantic-field

start_at: datetime

StygianDifficultyConfig pydantic-model

Configuration for a Stygian Onslaught difficulty.

Attributes:

Fields:

Validators:

  • __format_fields

descriptions pydantic-field

descriptions: list[str]

level pydantic-field

level: int

name pydantic-field

name: str

StygianEnemy pydantic-model

A Stygian Onslaught enemy.

Attributes:

Fields:

Validators:

  • __format_fields
  • __process_iconicon
  • __process_model

buffs pydantic-field

description pydantic-field

description: str

icon pydantic-field

icon: str

id pydantic-field

id: int

name pydantic-field

name: str

recommendation pydantic-field

recommendation: StygianEnemyRecommendation | None = None

StygianEnemyBuff pydantic-model

A buff associated with a Stygian Abyss enemy.

Attributes:

Fields:

Validators:

  • __format_fields

description pydantic-field

description: str

name pydantic-field

name: str

StygianEnemyRecommendation pydantic-model

Recommendations for dealing with a Stygian Abyss enemy.

Attributes:

Fields:

Validators:

dont_recommend pydantic-field

dont_recommend: str | None = None

recommend pydantic-field

recommend: str

StygianLevel pydantic-model

A Stygian Onslaught level.

Attributes:

Fields:

Validators:

  • __format_fields
  • __process_enemiesenemies

difficulty_config pydantic-field

difficulty_config: StygianDifficultyConfig

enemies pydantic-field

enemies: dict[int, StygianEnemy]

enemy_level pydantic-field

enemy_level: int

id pydantic-field

id: int

UpgradeMaterial pydantic-model

Represent a character's upgrade material.

Attributes:

  • name (str) –

    Name of the material.

  • id (int) –

    ID of the material.

  • count (int) –

    Count of the material.

  • rarity (Literal[0, 1, 2, 3, 4, 5]) –

    Rarity of the material.

Fields:

Validators:

  • __format_fields

count pydantic-field

count: int

icon property

icon: str

Get the material's icon URL.

id pydantic-field

id: int

name pydantic-field

name: str

rarity pydantic-field

rarity: Literal[0, 1, 2, 3, 4, 5]

UpgradeMaterialInfo pydantic-model

Represent character's upgrade material information.

Attributes:

Fields:

Validators:

  • __format_fields

materials pydantic-field

materials: list[UpgradeMaterial]

mora_cost pydantic-field

mora_cost: int

UpgradeMaterialInfos pydantic-model

Represent character's upgrade material information.

Attributes:

Fields:

Validators:

  • __format_fields

ascensions pydantic-field

talents pydantic-field

Weapon pydantic-model

Represent a Genshin Impact weapon.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon
  • __transform_names

description pydantic-field

description: str

icon pydantic-field

icon: str

id pydantic-field

id: int

name pydantic-field

name: str = ''

names pydantic-field

names: dict[Literal['en', 'zh', 'ko', 'ja'], str]

rarity pydantic-field

rarity: Literal[1, 2, 3, 4, 5]

WeaponDetail pydantic-model

Represent a Genshin Impact weapon detail.

Attributes:

Fields:

Validators:

  • __format_fields
  • __convert_iconicon

ascension pydantic-field

ascension: dict[str, dict[str, float]] | None = None

description pydantic-field

description: str

icon pydantic-field

icon: str

name pydantic-field

name: str

rarity pydantic-field

rarity: Literal[1, 2, 3, 4, 5]

refinments pydantic-field

refinments: dict[str, WeaponRefinement] | None = None

stat_modifiers pydantic-field

stat_modifiers: dict[str, WeaponStatModifier] | None = None

xp_requirements pydantic-field

xp_requirements: dict[str, float] | None = None

WeaponProperty pydantic-model

Represent a weapon's property.

Attributes:

Fields:

Validators:

  • __format_fields

growth_type pydantic-field

growth_type: str

init_value pydantic-field

init_value: float

type pydantic-field

type: str

WeaponRefinement pydantic-model

Represent a weapon's refinement.

Attributes:

Fields:

Validators:

  • __format_fields

description pydantic-field

description: str

name pydantic-field

name: str

parameters pydantic-field

parameters: list[float]

WeaponStatModifier pydantic-model

Represent a weapon's stat modifier.

Attributes:

Fields:

Validators:

  • __format_fields

base pydantic-field

base: float

levels pydantic-field

levels: dict[str, float]