logo
RunComfy
  • ComfyUI
  • TrainerNeu
  • Modelle
  • API
  • Preise
discord logo
MODELLE
Erkunden
Alle Modelle
BIBLIOTHEK
Generierungen
MODELL-APIS
API-Dokumentation
API-Schlüssel
KONTO
Nutzung

Minimax H3 Reference to Video: referenzgesteuerte 2K-Videogenerierung im Modellbereich und per API | RunComfy

minimax/minimax-h3/reference-to-video

Minimax H3 Reference to Video verwandelt Referenzbilder, Videoclips und Audiodateien zusammen mit einem Prompt in ein 5 bis 15 Sekunden langes 2K-Video und hält dabei Motiv und Bewegung konsistent.

Inhaltsverzeichnis

1. Erste Schritte2. Authentifizierung3. API-ReferenzAnfrage sendenAnfragestatus abrufenErgebnisse abrufenAnfrage abbrechen4. DateieingabenGehostete Datei (URL)5. SchemaEingabeschemaAusgabeschema

1. Erste Schritte

Nutzen Sie die RunComfy-API, um minimax/minimax-h3/reference-to-video auszuführen. Zulässige Ein- und Ausgaben finden Sie im Schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
    ],
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "2k"
  }'

2. Authentifizierung

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.

3. API-Referenz

Anfrage senden

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/minimax/minimax-h3/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look.",
    "reference_images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
    ],
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "2k"
  }'

Anfragestatus abrufen

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>"

Ergebnisse abrufen

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>"

Anfrage abbrechen

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>"

4. Dateieingaben

Gehostete Datei (URL)

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.

5. Schema

Eingabeschema

{
  "type": "object",
  "title": "Eingabeschema",
  "required": [
    "prompt",
    "reference_images",
    "aspect_ratio",
    "duration",
    "resolution"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Beschreibung von Szene, Interaktion, Bewegung und visuellem Stil. 1 bis 4000 Zeichen.",
      "type": "string",
      "default": "The woman from the reference steps out of the shadowed doorway into the low sun, dust lifting around her boots as she scans the street ahead. The camera tracks with her at shoulder height, warm light rakes across her face, and the background falls away into haze. Cinematic pacing, natural movement, anamorphic look."
    },
    "reference_images": {
      "title": "Referenzbilder",
      "description": "Referenzbilder, die Motiv, Produkt, Stil oder Komposition vorgeben. Bis zu 9 Bilder. Mindestens ein Referenzbild oder Referenzvideo ist erforderlich.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7394/media-files/ref-promo.webp"
      ],
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 9
    },
    "reference_videos": {
      "title": "Referenzvideos",
      "description": "Referenzvideos, die Bewegung, Tempo oder Interaktion vorgeben. Bis zu 3 Videos. Mindestens ein Referenzbild oder Referenzvideo ist erforderlich.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 3
    },
    "reference_audios": {
      "title": "Referenzaudios",
      "description": "Optionale Referenzaudios. Bis zu 3 Dateien. Sie können nicht ohne Bild- oder Videoreferenz verwendet werden.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "maxItems": 3
    },
    "aspect_ratio": {
      "title": "Seitenverhältnis",
      "description": "Seitenverhältnis des Ausgabevideos.",
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "Dauer",
      "description": "Länge des generierten Videos in Sekunden.",
      "type": "integer",
      "minimum": 5,
      "maximum": 15,
      "default": 5
    },
    "resolution": {
      "title": "Auflösung",
      "description": "Auflösung des Ausgabevideos.",
      "type": "string",
      "enum": [
        "2k"
      ],
      "default": "2k"
    }
  }
}

Ausgabeschema

{
  "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"
        }
      }
    }
  }
}
Folge uns
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • E-Mail
  • Systemstatus
  • Partner
Videomodelle
  • Wan 2.6 Flash
  • Wan 2.6 Text to Video
  • Hailuo 2.3 Fast Standard
  • Happy Horse 1.1 reference to video
  • Seedance 2.5 Reference to Video
  • Seedance 2.0 Pro
  • Alle Modelle anzeigen →
Bildmodelle
  • Seedream 5.0 Pro Image Edit
  • seedream 4.0
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • Nano Banana 2 Edit
  • GPT Image 2 Image Edit
  • Alle Modelle anzeigen →
Rechtliches
  • Nutzungsbedingungen
  • Datenschutzrichtlinie
  • Cookie-Richtlinie
RunComfy
Urheberrecht 2026 RunComfy. Alle Rechte vorbehalten.

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.