Erstellen Sie ein Bild-Asset

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/CreateAsset

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 Bild zu einer vorhandenen Gruppe hinzufügen. Referenzieren Sie es nach der Verarbeitung als asset://<ID> in einer unterstützten Seedance-Anfrage.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
GroupId	string	Ja	Ziel-Asset-Gruppen-ID.	group-20260320141746-zsf6b
AssetType	Image	Ja	Muss Image sein.	Image
URL	string	Ja	Öffentliche URL, Daten-URI oder unformatiertes Base64. Bilder müssen kleiner als 30 MB sein, 300–6000 Pixel auf jeder Seite haben und ein Seitenverhältnis von 0,4–2,5 haben.	https://example.com/image.jpg
file	binary	Nein	Mehrteilige Alternative zu URL. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF werden akzeptiert.	image.jpg
Name	string	Nein	Anzeige-/Suchname, bis zu 64 Zeichen. Es wird nicht an das Modell gesendet.	character-reference
model	string	Nein		volc-asset
ProjectName	string	Nein	Projektname. Es muss zur Zielgruppe passen; Der Standardwert ist default.	default

JSON-Beispiel:

JSON

{
  "model": "volc-asset",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "character-reference",
  "AssetType": "Image",
  "URL": "https://example.com/image.jpg"
}

Multipart/Form-Data-Beispiel:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@image.jpg"

Antwort

Das Bild befindet sich in der asynchronen Verarbeitung. Fragen Sie GetAsset ab, bis Status Active oder Failed ist. Es gibt kein SLA für die Upload-Zeit. Ein typisches Bild dauert etwa 6 bis 9 Sekunden, während eine überfüllte Überprüfungswarteschlange etwa 10 Sekunden bis 2 Minuten dauern kann.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
Id	string	Ja	Asset-ID. Verwenden Sie asset://<ID> nur, wenn der Status Active ist.	asset-20260528140922-d9646

Antwortbeispiel:

JSON

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

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.