Exporteer modelgebruik

Dit eindpunt exporteert AI-modelgebruiksgegevens inclusief tokenverbruik, kosten per model, aantal verzoeken en responstijden.

Probeer het (cURL):

curl
curl --request POST \
  --url https://api.langdock.com/export/models \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": {
    "date": "2024-01-01T00:00:00.000Z",
    "timezone": "UTC"
  },
  "to": {
    "date": "2024-01-31T23:59:59.999Z",
    "timezone": "UTC"
  }
}
'

Voorbeeldantwoord (200):

response.json
{
  "success": true,
  "data": {
    "filePath": "assistants-usage/workspace-id/assistants-usage-2024-01-01-2024-01-31-abc12345.csv",
    "downloadUrl": "https://storage.example.com/signed-url",
    "dataType": "assistants",
    "recordCount": 1250,
    "dateRange": {
      "from": "2024-01-01T00:00:00.000Z",
      "to": "2024-01-31T23:59:59.999Z"
    }
  }
}

Opgenomen gegevens

De modelexport bevat:

  • Gebruikte AI-modellen (GPT-4, Claude, enz.)

  • Tokenverbruik per model

  • Kosten per model

  • Aantal verzoeken

  • Responstijden

  • Foutenpercentages per model

  • Gebruikspatronen in de tijd


Kostenanalyse

De modelexport is vooral waardevol voor kostenanalyse en optimalisatie. U kunt deze gegevens gebruiken om:

  • De duurste modellen in uw gebruik te identificeren

  • Kostentrends in de loop van de tijd te volgen

  • Modelkeuze te optimaliseren voor verschillende gebruikssituaties

  • Budgetteren voor toekomstig AI-modelgebruik

Aanvullende details over vereisten, snelheidslimieten en limieten voor exportgrootte staan in de hoofddocumentatie van de Usage Export API: https://docs.langdock.com/api-endpoints/usage-export/intro-to-usage-export-api


1

Verzoek

POST /export/models

Beschrijving: Exporteer modelgebruiksgegevens.

Voorbeeld van verzoekbody (application/json):

{
  "from": {
    "date": "2024-01-01T00:00:00.000Z",
    "timezone": "UTC"
  },
  "to": {
    "date": "2024-01-31T23:59:59.999Z",
    "timezone": "UTC"
  }
}
2

Headers

  • Autorisatie (string, vereist) API-sleutel als Bearer-token met USAGE_EXPORT_API-scope. Formaat: "Bearer YOUR_API_KEY"

  • Content-Type: application/json

3

Antwoord (200)

Velden van een succesvolle respons:

  • success (boolean) — geeft aan of de export succesvol was. Voorbeeld: true

  • data (object)

    • data.filePath (string) — Pad naar het gegenereerde exportbestand. Voorbeeld: "assistants-usage/workspace-id/assistants-usage-2024-01-01-2024-01-31-abc12345.csv"

    • data.downloadUrl (string) — Gesigneerde URL om het exportbestand te downloaden. Voorbeeld: "https://storage.example.com/signed-url"

    • data.dataType (enum) — Type geëxporteerde gegevens. Opties: assistants, users, workflows, projects, models. Voorbeeld: "assistants"

    • data.recordCount (integer) — Aantal records in de export. Voorbeeld: 1250

    • data.dateRange (object)

      • data.dateRange.from (string) — Begindatum van de export. Voorbeeld: "2024-01-01T00:00:00.000Z"

      • data.dateRange.to (string) — Einddatum van de export. Voorbeeld: "2024-01-31T23:59:59.999Z"


Statuscodes

  • 200 — Export succesvol

  • 400 — Ongeldig verzoek

  • 401 — Niet geautoriseerd

  • 404 — Niet gevonden


Gerelateerd: Exporteer projectgebruik — https://docs.langdock.com/api-endpoints/usage-export/export-projects

Was deze pagina nuttig? Ja / Nee