Credits - Python SDK

Credits method reference

(credits)

Overview

Credit management endpoints

Available Operations

get_credits

Get total credits purchased and used for the authenticated user

Example Usage

1from openrouter import OpenRouter
2import os
3
4with OpenRouter(
5 api_key=os.getenv("OPENROUTER_API_KEY", ""),
6) as open_router:
7
8 res = open_router.credits.get_credits()
9
10 # Handle response
11 print(res)

Parameters

ParameterTypeRequiredDescription
retriesOptional[utils.RetryConfig]Configuration to override the default retry behavior of the client.

Response

operations.GetCreditsResponse

Errors

Error TypeStatus CodeContent Type
errors.UnauthorizedResponseError401application/json
errors.ForbiddenResponseError403application/json
errors.InternalServerResponseError500application/json
errors.OpenRouterDefaultError4XX, 5XX*/*

create_coinbase_charge

Create a Coinbase charge for crypto payment

Example Usage

1from openrouter import OpenRouter, operations
2import os
3
4with OpenRouter() as open_router:
5
6 res = open_router.credits.create_coinbase_charge(security=operations.CreateCoinbaseChargeSecurity(
7 bearer=os.getenv("OPENROUTER_BEARER", ""),
8 ), amount=100, sender="0x1234567890123456789012345678901234567890", chain_id=1)
9
10 # Handle response
11 print(res)

Parameters

ParameterTypeRequiredDescription
securityoperations.CreateCoinbaseChargeSecurity✔️N/A
amountfloat✔️N/A
senderstr✔️N/A
chain_idcomponents.ChainID✔️N/A
retriesOptional[utils.RetryConfig]Configuration to override the default retry behavior of the client.

Response

operations.CreateCoinbaseChargeResponse

Errors

Error TypeStatus CodeContent Type
errors.BadRequestResponseError400application/json
errors.UnauthorizedResponseError401application/json
errors.TooManyRequestsResponseError429application/json
errors.InternalServerResponseError500application/json
errors.OpenRouterDefaultError4XX, 5XX*/*