Create a key
When creating a key, choose:| Field | Description |
|---|---|
| Name | Human-readable name, for example Production catalog import. |
| Environment | Sandbox or Live. This cannot be changed after creation. |
| Expiration date | Optional. Expired keys cannot authenticate. |
Environments
| Environment | Prefix | Behavior |
|---|---|---|
| Sandbox | aigen_test_ | Validates API behavior without provider calls or credit usage. |
| Live | aigen_live_ | Processes real images and consumes paid API credits. |
Lifecycle actions
| Action | Behavior |
|---|---|
| Deactivate | Disables the key immediately. Requests fail with api_key_inactive. |
| Reactivate | Allows the key to authenticate again if it is not expired or deleted. |
| Revoke | Permanently disables the key. It cannot be reactivated. |
| Delete | Removes the key from the active key list and permanently prevents authentication. |
| Expire | A key with a past expiration date cannot authenticate, even if active. |
Limits
Rotation strategy
- Create a new key in the same environment.
- Deploy the new key to your backend secret store.
- Confirm new API requests succeed.
- Deactivate the old key.
- Revoke or delete the old key after the rollback window expires.
