Zum Hauptinhalt springen

Einführung

Face Change ist ein von Ace Data Cloud bereitgestellter KI-Bilddienst für die KI-Gesichtsverarbeitung. Über die einheitliche API von Ace Data Cloud können Sie Face Change schnell mit cURL aufrufen, um Funktionen wie Gesichtstausch, Gesichtsverschönerung, Altersänderung, Geschlechtsänderung, Anime-Stilisierung und Gesichtsanalysen zu realisieren.

Voraussetzungen

  • Ein Konto bei Ace Data Cloud besitzen und einen API-Token erhalten
  • Ein Terminal mit installiertem cURL

Grundlegende Verwendung

Der Hauptendpunkt für den Aufruf der Face Change API ist:
POST https://api.acedata.cloud/face/swap
Vollständiges Beispiel für einen cURL-Befehl:
curl -X POST https://api.acedata.cloud/face/swap \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_image_url": "https://example.com/source-face.jpg", "target_image_url": "https://example.com/target-face.jpg"}'
Ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

Antwortbeispiel

Nach erfolgreichem Aufruf wird eine JSON-Antwort zurückgegeben, z. B.:
{
  "status": "success",
  "data": {
    ...
  }
}

Verarbeitung der Antwort mit jq

Es wird empfohlen, das Tool jq zur Formatierung der Ausgabe zu verwenden:
curl -s -X POST https://api.acedata.cloud/face/swap \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_image_url": "https://example.com/source-face.jpg", "target_image_url": "https://example.com/target-face.jpg"}' | jq .

Fehlerbehandlung

Häufige Fehlercodes:
StatuscodeBeschreibung
401Authentifizierung fehlgeschlagen, bitte API-Token überprüfen
403Unzureichendes Guthaben oder kein Zugriff
429Anfragelimit überschritten
500Interner Serverfehler

Nächste Schritte