Added example of admin api usage

Author: MattDavisRV

examples/admin_usage/README.md

@@ -0,0 +1,7 @@
+### OpenAI Administration Endpoints
+
+The examples in this directory require the use of an Admin API Key, which differ from a normal API key.  You must create at least one Admin API Key using the OpenAI Console before using these functions.
+
+You can generate the link in the [Admin Keys Console](https://platform.openai.com/organization/admin-keys).
+
+For additional information, refer to the Administrator section of the [API Reference](https://platform.openai.com/docs/api-reference/administration).

examples/admin_usage/main.go

@@ -0,0 +1,62 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"time"
+
+	"github.com/sashabaranov/go-openai"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Admin API Keys are different than regular API keys and require a different
+	// endpoint to be used. You can find your Admin API key in the OpenAI dashboard.
+	config := openai.DefaultConfig(os.Getenv("OPENAI_ADMIN_API_KEY"))
+	client := openai.NewClientWithConfig(config)
+
+	// Specify the date range of the usage data you want to retrieve, the end date is optional,
+	// but when specified, it should include through the end of the day you want to retrieve.
+	startTime := convertDateStringToTimestamp("2025-02-01")
+	endTime := convertDateStringToTimestamp("2025-03-01")
+
+	// In this example each bucket represents a day of usage data. To avoid
+	// making several requests to get the data for each day, we'll increase
+	// the limit to 31 to get all the data in one request.
+	limit := 31
+
+	// Create the request object, only StartTime is required.
+	req := openai.AdminUsageCostRequest{
+		StartTime: startTime,
+		EndTime:   &endTime,
+		Limit:     &limit,
+	}
+
+	// Request the usage data.
+	res, err := client.GetAdminUsageCost(ctx, req)
+	if err != nil {
+		fmt.Printf("error getting openai usage data: %v\n", err)
+		return
+	}
+
+	// Calculate the total cost of the usage data.
+	totalCost := 0.0
+	for _, bucket := range res.Data {
+		for _, cost := range bucket.Results {
+			totalCost += cost.Amount.Value
+		}
+	}
+
+	fmt.Printf("Total Cost: %f\n", totalCost)
+}
+
+// Helper function to convert a date string to a Unix timestamp.
+func convertDateStringToTimestamp(date string) int64 {
+	t, err := time.Parse("2006-01-02", date)
+	if err != nil {
+		panic(err)
+	}
+	return t.Unix()
+}