Create a new API key | OpenRouter

1 import requests 2 3 url = "https://openrouter.ai/api/v1/keys" 4 5 payload = { 6 "name": "My New API Key", 7 "limit": 50, 8 "limit_reset": "monthly", 9 "include_byok_in_limit": True 10 } 11 headers = { 12 "Authorization": "Bearer <token>", 13 "Content-Type": "application/json" 14 } 15 16 response = requests.post(url, json=payload, headers=headers) 17 18 print(response.json())

1 { 2 "data": { 3 "hash": "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", 4 "name": "My New API Key", 5 "label": "My New API Key", 6 "disabled": false, 7 "limit": 50, 8 "limit_remaining": 50, 9 "limit_reset": "monthly", 10 "include_byok_in_limit": true, 11 "usage": 0, 12 "usage_daily": 0, 13 "usage_weekly": 0, 14 "usage_monthly": 0, 15 "byok_usage": 0, 16 "byok_usage_daily": 0, 17 "byok_usage_weekly": 0, 18 "byok_usage_monthly": 0, 19 "created_at": "2025-08-24T10:30:00Z", 20 "updated_at": null 21 }, 22 "key": "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" 23 }

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

namestringRequired>=1 character

Name for the new API key

limitdouble or nullOptional

Optional spending limit for the API key in USD

limit_resetenum or nullOptional

Type of limit reset for the API key (daily, weekly, monthly, or null for no reset). Resets happen automatically at midnight UTC, and weeks are Monday through Sunday.

Allowed values:

include_byok_in_limitbooleanOptional

Whether to include BYOK usage in the limit

Response

API key created successfully

dataobject

The created API key information

keystring

The actual API key string (only shown once)