Nutzen Sie die RunComfy-API, um heygen/avatar-v/text-to-video auszuführen. Zulässige Ein- und Ausgaben finden Sie im Schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"avatar_id": "Elise",
"voice_id": "Match look",
"script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
}'Weisen Sie der Umgebungsvariable YOUR_API_TOKEN Ihren API-Schlüssel zu (Verwaltung unter Profil). Senden Sie bei jeder Anfrage im Header Authorization einen Bearer-Token: Authorization: Bearer $YOUR_API_TOKEN.
Senden Sie einen asynchronen Generierungsauftrag und erhalten Sie sofort eine request_id sowie URLs für Status, Ergebnisse und Abbruch.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/heygen/avatar-v/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"avatar_id": "Elise",
"voice_id": "Match look",
"script": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
}'Ruft den aktuellen Status für eine request_id ab („in_queue“, „in_progress“, „completed“ oder „cancelled“).
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Ruft die endgültigen Ausgaben und Metadaten für die angegebene request_id ab; ist der Auftrag noch nicht fertig, liefert die Antwort den aktuellen Status zum Weiterpollen.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Bricht einen wartenden Auftrag per request_id ab; laufende Aufträge können nicht abgebrochen werden.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Geben Sie eine öffentlich erreichbare HTTPS-URL an. Der Host muss serverseitige Abrufe erlauben (ohne Login/Cookies), nicht drosseln oder Bots blockieren. Empfohlen: Bilder ≤ 50 MB (~4K), Videos ≤ 100 MB (~2–5 Min. bei 720p). Für private Assets stabile oder vorab signierte URLs verwenden.
{
"type": "object",
"title": "Eingabeschema",
"required": [
"avatar_id",
"voice_id",
"script"
],
"properties": {
"avatar_id": {
"title": "Avatar",
"description": "Öffentlicher Look, der auf der Kamera erscheint. Jede Option akzeptiert diese Rendering-Engine.",
"type": "string",
"enum": [
"Elise",
"Dante Office 2",
"Genevieve Office 3",
"Brody Living Room 2",
"Elodie Kitchen 9",
"Julian Office 8",
"Camille",
"Sebastian Office 11"
],
"default": "Elise"
},
"voice_id": {
"title": "Stimme",
"description": "Stimme, die das Skript spricht. Match Look verwendet die Stimme, die mit der ausgewählten Person gepaart ist.",
"type": "string",
"enum": [
"Match look",
"Nadine - Calm & Gentle",
"Vincent - Thoughtful & Clear",
"Jonah - Clear & Professional",
"Elowen - Warm & Soothing",
"Hugh - Firm & Measured",
"Cecily - Warm & Friendly",
"Lucian - Conversational & Easygoing",
"Noelle - Warm & Soothing"
],
"default": "Match look"
},
"script": {
"title": "Skript",
"description": "Wörter zu sprechen. Cliplänge folgt diesem Text.",
"type": "string",
"maxLength": 5000,
"default": "Good morning. The harbor market opens in ten minutes, and the first crates of peaches are already on the tables."
},
"resolution": {
"title": "Auflösung",
"description": "Rahmengröße. 720p und 1080p verwenden die gleiche Rate pro Sekunde.",
"type": "string",
"enum": [
"720p",
"1080p"
],
"default": "1080p"
},
"motion_prompt": {
"title": "Bewegungsaufforderung",
"description": "Optionaler Hinweis für ein Nicken, eine Geste oder ruhigere Hände. Leer lassen, um das Skript führen zu lassen.",
"type": "string",
"default": "A small nod, then one open hand toward the camera."
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "Einzelbild-URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "Einzelvideo-URL"
},
"images": {
"type": "array",
"description": "mehrere Bild-URLs",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "mehrere Video-URLs",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy ist die führende ComfyUI Plattform, die ComfyUI online Umgebung und Services bietet, zusammen mit ComfyUI Workflows mit atemberaubenden Visualisierungen. RunComfy bietet auch AI Models, Künstlern ermöglichen, die neuesten AI-Tools zu nutzen, um unglaubliche Kunst zu schaffen.