Skip to main content
GET
/
usage
API usage
curl --request GET \
  --url https://api.us.babysea.ai/v1/usage \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "request_id": "<string>",
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "data": {
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "usage_period_days": 123,
    "usage_credit_balance": 123,
    "usage_total_requests": 123,
    "usage_total_success": 123,
    "usage_total_client_errors": 123,
    "usage_total_server_errors": 123,
    "usage_total_generations": 123,
    "usage_total_provider_submissions": 123,
    "usage_total_estimated_cost": 123,
    "usage_endpoints": [
      {
        "endpoint": "<string>",
        "total_requests": 123,
        "success_count": 123,
        "client_error_count": 123,
        "server_error_count": 123,
        "error_codes": {}
      }
    ],
    "usage_providers": [
      {
        "provider": "<string>",
        "total_submissions": 123,
        "used_count": 123,
        "cancelled_count": 123,
        "discarded_count": 123,
        "failed_count": 123,
        "total_estimated_cost": 123,
        "wasted_estimated_cost": 123
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

BabySea API key - prefix bye_ followed by a random string

Query Parameters

days
integer
default:30

Lookback window in days (1-90), defaults to 30

Required range: 1 <= x <= 90

Response

200 - application/json

Usage data retrieved successfully

Response envelope

status
enum<string>
required

Always success

Available options:
success
request_id
string
required

Unique request identifier (UUID v4)

message
string
required

Success message

timestamp
string<date-time>
required

Response timestamp (ISO 8601)

data
object
required