Holen Sie sich einen Vermögenswert

Verfügbarkeit

Diese Seite dokumentiert den Asset-Management-Weg von Modelflare. Für Aufrufe sind ein gültiger Smart-API-Schlüssel oder Mediengruppen-API-Schlüssel, ein verfügbarer Medienkanal und die erforderliche Berechtigung erforderlich.

Hinweis

Das Gateway zeichnet die Asset-IDs, den Status und den Benutzerbesitz des Anbieters auf. Die lokale Castaly-Bibliothek bleibt vom Asset-Namespace des Anbieters getrennt.

Endpunkt

POST https://modelflare.dev/volc/asset/GetAsset

Authentifizierung

Verwenden Sie einen Modelflare-API-Schlüssel:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Senden Sie Idempotency-Key mit Anfragen zum Erstellen, Aktualisieren und Löschen. Wenn Sie denselben Schlüssel für denselben Benutzer erneut versuchen, wird die gespeicherte Antwort erneut abgespielt, ohne dass die Mutation wiederholt wird.

Anfrage

Ein Asset nach ID lesen. Verwenden Sie diese Route, um einen asynchronen Upload abzufragen, bis Status Active oder Failed ist.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
Id	string	Ja	abzufragende Asset-ID.	asset-20260528140922-d9646

JSON-Beispiel:

JSON

{
  "Id": "asset-20260528140922-d9646"
}

cURL-Beispiel:

bash

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

Antwort

Die Anfrage war erfolgreich.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
Id	string	Ja	Asset-ID.	asset-20260528140922-d9646
Name	string	Nein	Asset-Name.	character-reference
URL	string	Nein	Temporäre Datei-URL. Die dokumentierte Lebensdauer beträgt 12 Stunden; Behalten Sie es nicht als Generierungsreferenz bei.	https://example.com/temporary-asset
AssetType	Image	Video	Audio	Nein
GroupId	string	Nein	Eigentümergruppen-ID.	group-20260320141746-zsf6b
Status	Processing	Active	Failed	Nein
ProjectName	string	Nein	Projektname.	default
CreateTime / UpdateTime	string	Nein	ISO 8601-Zeitstempel.	2026-05-28T06:09:31Z

Antwortbeispiel:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

Fehler

Status	Bedeutung
400	Die Anfrage ist ungültig.
401	Der API-Schlüssel fehlt oder ist nicht autorisiert.

Beispiel für einen Fehlertext (bei Rückgabe):

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Die Erstellung von Bildern, Videos und Audio erfolgt asynchron. Rufen Sie nach Erhalt einer Asset-ID GetAsset auf und verwenden Sie die asset://<ID>-Referenz nur, wenn der Status Active ist.