Getting Started

Authentication

Every request needs an API key. Keys are free and do not require an account.

Send your API key in the X-API-Key header of every request. Requests without a key, or with an invalid or revoked one, return401.

cURL
curl -H "X-API-Key: YOUR_API_KEY" https://cdn.genshin-api.com/api/v1/characters/hu-tao

Get a key

Keys are generated only here, after a quick check that you are human. The key is saved in this browser so the "Try it" boxes use it.

Revoke a key

Send a DELETE request authenticated with the key you want to revoke. It stops working immediately (within a minute at most).

DELETE/api/v1/keysRevoke the key sent in the header
cURL
curl -X DELETE -H "X-API-Key: YOUR_API_KEY" https://cdn.genshin-api.com/api/v1/keys
DELETE /api/v1/keys · 200
{
  "revoked": true,
  "revokedAt": "2026-11-20T09:12:41.513Z"
}