deepgram-java-management-api
/deepgram-java-management-api
Obsługuje w Javie interfejsy zarządzania Deepgram: projekty, modele projektu, klucze API, członków, zaproszenia, zużycie i rozliczenia przez client.manage().v1() oraz wykrywanie modeli think.
- Autor
- deepgram ↗
- Repozytorium
- deepgram-java-sdk ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 5
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Obsługuje w Javie interfejsy zarządzania Deepgram: projekty, modele projektu, klucze API, członków, zaproszenia, zużycie i rozliczenia przez client.manage().v1() oraz wykrywanie modeli think.
Wyzwalacze z opisu
Oryginalny opis (EN)
Use when writing or reviewing Java code in this repo that calls Deepgram Management APIs for projects, project models, API keys, members, invites, usage, and billing. Covers `client.manage().v1().*` plus related think-model discovery under `client.agent().v1().settings().think().models()`. Use `deepgram-java-voice-agent` for live agent conversations instead of admin APIs. Triggers include "management api", "list projects", "api keys", "members", "invites", "usage", "billing", and "models".
Jak działa
- When to use this product
- Authentication
- Quick start — projects
- Quick start — project models / keys
- Key parameters / API surface
- API reference (layered)
- Gotchas
- Example files in this repo
- Central product skills
Podgląd SKILL.md
---
name: deepgram-java-management-api
description: Use when writing or reviewing Java code in this repo that calls Deepgram Management APIs for projects, project models, API keys, members, invites, usage, and billing. Covers `client.manage().v1().*` plus related think-model discovery under `client.agent().v1().settings().think().models()`. Use `deepgram-java-voice-agent` for live agent conversations instead of admin APIs. Triggers include "management api", "list projects", "api keys", "members", "invites", "usage", "billing", and "models".
---
# Using Deepgram Management API (Java SDK)
Administrative REST APIs for project metadata, project-scoped resources, and model discovery.
## When to use this product
- List or inspect projects.
- Manage project keys, members, invites, usage, or billing.
- Discover public or project-scoped STT/TTS models.
**Use a different skill when:**
- You want to run a live agent session → `deepgram-java-voice-agent`.
- You want speech/text inference rather than project administration → use the product skills for STT, TTS, or Read.
## Authentication
```java
import com.deepgram.DeepgramClient;
DeepgramClient client = DeepgramClient.builder()
.apiKey(System.getenv("DEEPGRAM_API_KEY"))
.build();
```
Management endpoints require API-key auth. Temporary JWTs from `auth().v1().tokens().grant()` do **not** work for Manage APIs.
## Quick start — projects
```java
import com.deepgram.types.ListProjectsV1Response;
import com.deepgram.types.ListProjectsV1ResponseProjectsItem;
import java.util.Collections;
import java.util.List;
ListProjectsV1Response response = client.manage().v1().projects().list();
List<ListProjectsV1ResponseProjectsItem> projects = response.getProjects().orElse(Collections.emptyList());
for (ListProjectsV1ResponseProjectsItem project : projects) {
System.out.printf("%s (%s)%n",
project.getName().orElse("unnamed"),
project.getProjectId().orElse("unknown"));
}
```
## Quick start — project models / keys
Pick a project from the list above. New accounts may have zero projects — guard against that before indexing.
```java
if (projects.isEmpty()) {
throw new IllegalStateException("No Deepgram projects are visible to this API key.");
}
String projectId = projects.get(0).getProjectId().orElseThrow();
client.manage().v1().projects().models().list(projectId);
client.manage().v1().projects().keys().list(projectId);
client.manage().v1().projects().members().list(projectId);
client.manage().v1().projects().members().invites().list(projectId);
client.manage().v1().projects().usage().get(projectId);
client.manage().v1().projects().billing().balances().list(projectId);
```
## Key parameters / API surface
- Top-level public models: `client.manage().v1().models().list()` and `.get(modelId)`
- Projects: `projects().list()`, `get(projectId)`, `update(projectId, ...)`, `delete(projectId)`, `leave(projectId)`
- Keys: `projects().keys().list/create/get/delete`
- Members: `projects().members().list/delete`
- Invites: `projects().members().invites().list/create/delete`
- Project models: `projects().models().list(projectId)`
- Usage: `projects().usage().get(projectId)`
- Billing: `projects().billing().balances().list(projectId)`
- Requests: `projects().requests()` subtree exists in the generated API surface
- Agent think-model discovery: `client.agent().v1().settings().think().models().list()`
- Most clients expose `withRawResponse()` alongside typed methods
## API reference (layered)
1. **In-repo source of truth**: `src/main/java/com/deepgram/resources/manage/v1/`, `src/main/java/com/deepgram/resources/agent/v1/settings/think/models/`, and `examples/manage/`. There is no `reference.md` in this checkout.
2. **Canonical OpenAPI**: https://developers.deepgram.com/openapi.yaml
3. **Context7**: `/llmstxt/developers_deepgram_llms_txt`
4. **Product docs**:
- https://developers.deepgram.com/reference/manage/projects/list
- https://developers.deepgram.com/reference/manage/models/list
- https://developers.deepgram.com/reference/auth/grant-token
- https://developers.deepgram.com/reference/voice-agent/think-models
## Gotchas
1. **Use an API key, not a temporary JWT, for Manage APIs.** The token-grant endpoint explicitly says those JWTs do not work here.
2. **Some example files are intentionally excluded from Gradle `compileExamples`.** `manage/ListModels.java`, `manage/MemberPermissions.java`, and `manage/UsageBreakdown.java` are currently excluded in `build.gradle`.
3. **Many manage examples are read-only by default.** Create/delete snippets are commented out to avoid destructive calls.
4. **Project-scoped model discovery and global model discovery are different.** `models().list()` returns public models; `projects().models().list(projectId)` returns what a project can use.
5. **This checkout does not expose the Python-style persisted voice-agent configuration client.** Do not promise `voice_agent.configurations.*` here.
6. **The SDK is highly nested.** For invites, the path is `projects().members().invites()`, not a top-level `invites()` client.
## Example files in this repo
- `examples/manage/ListProjects.java`
- `examples/manage/ProjectModels.java`
- `examples/manage/ManageKeys.java`
- `examples/manage/ManageMembers.java`
- `examples/manage/ManageInvites.java`
- `examples/manage/GetUsage.java`
- `examples/manage/Billing.java`
- `examples/agent/ListModels.java`
## Central product skills
For cross-language Deepgram product knowledge — the consolidated API reference, documentation finder, focused runnable recipes, third-party integration examples, and MCP setup — install the central skills:
```bash
npx skills add deepgram/skills
```
This SDK ships language-idiomatic code skills; `deepgram/skills` ships cross-language product knowledge (see `api`, `docs`, `recipes`, `examples`, `starters`, `setup-mcp`).
Wersje
W bazie nie ma innych skilli o nazwie deepgram-java-management-api.
Migawka bazy z 13.11.2026 · wersja paczki 8d089f6d77ec (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100deepgram-js-management-api
Obsługuje w JavaScripcie i TypeScripcie API zarządzania Deepgram: projekty, klucze API, członkowie, zaproszenia, żądania, użycie, rozliczenia, modele i wykrywanie modeli think agenta. - 100deepgram-python-management-api
Obsługuje w Pythonie API zarządzania Deepgram: projekty, klucze API, członkowie, zaproszenia, użycie, rozliczenia, modele oraz konfiguracje Voice Agent wielokrotnego użytku. - 100deepgram-go-management-api
Obsługuje w Go punkty końcowe zarządzania Deepgram: projekty, klucze, członków, zakresy, zaproszenia, zużycie, salda, modele, wielokrotnego użytku konfiguracje agentów i zmienne agentów. - 100deepgram-dotnet-management-api
Obsługuje w C# interfejsy zarządzania Deepgram: projekty, modele, klucze, członków, zaproszenia, zużycie, salda i tokeny autoryzacyjne przez ClientFactory.CreateManageClient i CreateAuthClient. - 100deepgram-rust-management-api
Wdraża w Rust operacje Deepgram na projektach, kluczach, członkach, zakresach, rozliczeniach, zaproszeniach i zużyciu, z flagami funkcji manage oraz API Deepgram::projects, keys, members, scopes, billing i usage. - 100deepgram-java-text-intelligence
Obsługuje w Javie Deepgram Text Intelligence (/v1/read) do analizy tekstu: sentyment, tematy, intencje i podsumowania przez client.read().v1().text().analyze z ReadV1Request lub TextAnalyzeRequest.