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 -H "X-API-Key: YOUR_API_KEY" https://cdn.genshin-api.com/api/v1/characters/hu-taoGet 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.
Your key
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 headercurl -X DELETE -H "X-API-Key: YOUR_API_KEY" https://cdn.genshin-api.com/api/v1/keys{
"revoked": true,
"revokedAt": "2026-11-20T09:12:41.513Z"
}