Partner-API-Endpunkte

Basis-URL: https://panel.model-gate.com/api/v1/partner

Authentifizieren Sie jede Anfrage mit Authorization: Bearer mg_partner_....

API-Schlüssel

• POST /keys
• GET /keys
• GET /keys/{id}
• PATCH /keys/{id}
• DELETE /keys/{id}
• POST /keys/{id}/freeze
• POST /keys/{id}/unfreeze
• POST /keys/{id}/rotate
• POST /keys/{id}/reset-usage
• GET /keys/{id}/usage
• GET /keys/{id}/spent-limit

Wichtige Felder zum Erstellen und Aktualisieren: name, group_id, rpm_limit, concurrency_limit, spend_limit. Eine numerische Grenze von 0 bedeutet unbegrenzt. group_id ist die öffentliche Gruppen-ID oder ein leerer Wert für keine Gruppe.

Schlüsselgruppen

• GET /groups
• POST /groups
• GET /groups/{id}
• PATCH /groups/{id}
• DELETE /groups/{id}
• POST /groups/{id}/reset-usage
• GET /groups/{id}/usage
• GET /groups/{id}/stats
• GET /groups/{id}/members
• POST /groups/{id}/members
• DELETE /groups/{id}/members/{keyId}

Felder zum Erstellen und Aktualisieren von Gruppen: name, description, status, rpm_limit, concurrency_limit, spend_limit. Status ist active oder frozen.

Schlüssel- und Gruppen-RPM, Parallelität und Ausgabenlimits werden unabhängig voneinander durchgesetzt. Eine Anfrage wird abgelehnt, wenn eine der Ebenen ihr Limit überschreitet. Durch das Verschieben eines Schlüssels zwischen Gruppen werden historische Statistiken nicht neu geschrieben: Bei jeder Anfrage wird der Gruppen-Snapshot zum Zeitpunkt der Anfrage erfasst.

Durch die Reset-Nutzung wird die zurücksetzbare Funktion gelöscht usage Fenster und Updates usage_reset_at; es ändert sich nie total_spent.

Transaktionen und asynchrone Ergebnisse

• GET /transactions
• GET /requests/{request_id}

Gruppenstatistiken verwenden aggregierte Tabellen für abgeschlossene Zeiträume und Rohdaten api_requests nur für die aktuelle unvollständige Stunde.

Bezeichnerkonvention: jeder {id} in dieser Dokumentation ist die Ressource public_id. Interne numerische Datenbank-IDs werden niemals akzeptiert oder zurückgegeben. In verschachtelten Mitgliedsrouten {keyId} ist der API-Schlüssel public_id.