UsageResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0si-ai/json-schema/0si-ai-usage-response-schema.json",
  "title": "UsageResponse",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0si-ai-openapi.json#/components/schemas/UsageResponse",
  "type": "object",
  "required": [
    "object",
    "data",
    "meta"
  ],
  "properties": {
    "object": {
      "const": "usage"
    },
    "data": {
      "type": "object",
      "properties": {
        "request_count": {
          "type": "integer",
          "description": "Lifetime requests made with this key"
        },
        "last_used_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "last_request_path": {
          "type": "string"
        },
        "current_minute": {
          "type": "object",
          "properties": {
            "request_count": {
              "type": "integer"
            },
            "window_started_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          }
        },
        "active_streams": {
          "type": "integer"
        },
        "active_webhooks": {
          "type": "integer"
        },
        "webhook_deliveries_24h": {
          "type": "integer"
        },
        "webhook_delivered_24h": {
          "type": "integer"
        },
        "rate_limit": {
          "type": "object",
          "required": [
            "limit",
            "remaining",
            "reset"
          ],
          "properties": {
            "limit": {
              "type": "integer"
            },
            "remaining": {
              "type": "integer"
            },
            "reset": {
              "type": "integer",
              "description": "Unix timestamp"
            }
          }
        },
        "limits": {
          "type": "object",
          "properties": {
            "max_concurrent_streams": {
              "type": "integer"
            },
            "max_webhooks": {
              "type": "integer"
            },
            "requests_per_day": {
              "type": "integer",
              "description": "Free daily allowance (trial and credit plans)"
            },
            "data_delay_seconds": {
              "type": "integer",
              "description": "Publication delay applied to the trial plan"
            }
          }
        },
        "plan": {
          "$ref": "#/$defs/Plan"
        },
        "credits": {
          "type": "object",
          "description": "Present when prepaid credits are enabled for the account",
          "properties": {
            "balance": {
              "type": "integer"
            },
            "free_requests_per_day": {
              "type": "integer"
            },
            "top_up_url": {
              "type": "string",
              "format": "uri"
            },
            "key_budget": {
              "type": "object",
              "description": "This key's monthly credit budget (UTC month)",
              "properties": {
                "monthly_limit": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "null means no limit"
                },
                "spent_this_month": {
                  "type": "integer"
                },
                "settings_url": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          }
        }
      }
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    }
  },
  "$defs": {
    "Meta": {
      "type": "object",
      "required": [
        "request_id",
        "generated_at",
        "api_version"
      ],
      "properties": {
        "request_id": {
          "type": "string"
        },
        "generated_at": {
          "type": "string",
          "format": "date-time"
        },
        "api_version": {
          "type": "string",
          "const": "v1"
        }
      }
    },
    "Plan": {
      "type": "string",
      "enum": [
        "pro",
        "trial",
        "credit"
      ],
      "description": "pro: Pro subscription. trial: free daily allowance. credit: the account holds prepaid credits (real-time data; calls beyond the free allowance spend one credit each)."
    }
  }
}