apimart-zoe API

apimart-zoe ist ein multimodales Videogenerierungsmodell von APIMart, das mit der Modell-ID apimart-zoe aufgerufen wird. Die apimart-zoe API unterstützt Text-zu-Video, Video aus erstem und letztem Frame, Video aus Bild-, Video- und Audioreferenzen, die Bearbeitung bestehender Videos, optional zusammen mit dem Video erzeugtes Audio sowie einen zweistufigen Ablauf vom 480p-Entwurf zum 1080p-Finalvideo. Clips sind 4–30 Sekunden lang, in 480p, 720p, 1080p, 2k oder 4k.

Senden Sie POST /v1/videos/generations mit model apimart-zoe und Ihrem Prompt sowie dem Header Authorization: Bearer <API-Key>. Die Antwort liefert eine task_id. Die Generierung dauert meist 1–3 Minuten: Fragen Sie GET /v1/tasks/{task_id} alle 5–10 Sekunden ab, bis data.status completed ist, und lesen Sie dann die Video-URL aus data.result.videos[0].url[0]. Das Beispiel auf dieser Seite enthält cURL- und Python-Code, die vollständige Referenz der apimart-zoe API finden Sie in der APIMart-Dokumentation.

model (apimart-zoe) ist Pflicht. prompt ist bei Text-zu-Video Pflicht, optional, wenn Sie nur Medien senden, und bis zu 204.800 Zeichen lang. Optional sind resolution (480p, 720p, 1080p, 2k oder 4k), aspect_ratio oder size (21:9, 16:9, 4:3, 1:1, 3:4, 9:16 oder adaptive), duration oder seconds (4–30 oder -1), audio oder generate_audio, seed, image_with_roles, image_urls (Aliasse image, images, image_url), first_frame_image, last_frame_image, video_urls, audio_urls, draft, draft_task_id, omni_reference_task_type (auto, reference oder edit), return_last_frame, output_format oder response_format (mp4 oder mov) und enhance_prompt sowie das APIMart-Feld nsfw_check. negative_prompt, camera_fixed (auch camerafixed), extend_from_task_id, mask_url, video_list, element_list, multi_shot und tools werden nicht unterstützt: Sobald das Feld in der Anfrage steht, auch leer, false oder null, kommt 400 zurück. n darf nur fehlen oder 1 sein. Die Parametertabelle auf dieser Seite nennt Standardwerte und Grenzen.

Setzen Sie duration (oder seconds) auf eine ganze Zahl von 4 bis 30; Standard ist 5, und -1 überlässt die Länge dem Modell. resolution ist 480p, 720p (Standard), 1080p, 2k oder 4k, unabhängig von Groß- und Kleinschreibung. aspect_ratio, auch als size akzeptiert, ist 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 oder adaptive (Standard; Modell oder Medien bestimmen den Bildausschnitt). Bei einer Videobearbeitung lassen Sie duration und aspect_ratio weg (oder senden -1 und adaptive); Länge und Bildformat folgen dann dem Quellvideo. Entwürfe sind immer 480p, Finalvideos 1080p.

Ja. Senden Sie image_with_roles mit first_frame und last_frame oder nutzen Sie first_frame_image und last_frame_image. Jedes Frame nimmt ein Bild auf, und ein letztes Frame setzt ein erstes voraus. Eine Anfrage mit erstem und letztem Frame darf keine Referenzbilder, -videos oder -audio enthalten; eine solche Anfrage gibt 400 zurück und wird nicht berechnet. Beschreiben Sie im Prompt, wie die Einstellung von einem Frame zum anderen verläuft.

Bis zu 30 Referenzbilder, 10 Referenzvideos und 10 Referenz-Audioclips, insgesamt höchstens 50 Dateien; Referenz-Audio braucht ein Referenzbild oder -video. Bilder: jpeg, png, webp, bmp, tiff, gif, heic oder heif, 300–6000 Pixel pro Seite, Seitenverhältnis 0,4–2,5, unter 30 MB. Videos: mp4 oder mov (H.264/H.265, Tonspur AAC oder MP3), je 2–15 Sekunden (1,8–15,2 s werden akzeptiert) und bis zu 200 MB, Breite und Höhe je 300–6000 Pixel, Breite × Höhe zwischen 409.600 und 8.295.044 (etwa 640×640 bis 3840×2160), Seitenverhältnis 0,4–2,5, 24–60 fps nach Rundung (23,976 und 59,94 sind zulässig); das Quellvideo einer Videobearbeitung darf 4–30 Sekunden lang sein (mindestens 3,8 s, unter 30,2 s), und ohne Aufgabentyp brauchen Videos über 15 Sekunden edit. Audio: wav oder mp3, je 2–15 Sekunden (1,8–15,2 s) und bis zu 15 MB, insgesamt höchstens 30 Sekunden (bis 30,2 s). Länge, Abmessungen, Seitenverhältnis und Bildrate der Referenzvideos sowie die Länge der Referenz-Audios werden beim Absenden geprüft; passt etwas nicht, kommt 400 invalid_request_error zurück, ohne Berechnung. Bildabmessungen, Dateigröße und Kodierung werden erst bei der Generierung geprüft; passt etwas nicht, schlägt die Aufgabe fehl und der Betrag wird automatisch erstattet – prüfen Sie Ihre Dateien daher vorab. Alle Medien müssen öffentliche http(s)-URLs oder asset://-IDs sein; data:-URIs werden nicht angenommen, laden Sie Dateien also zuerst an eine öffentlich erreichbare Adresse hoch. Beim Absenden registriert APIMart jede Datei automatisch; dieselbe Datei wird innerhalb von 7 Tagen nicht erneut registriert. Wenn Sie nur Medien senden, kann prompt entfallen.

Senden Sie eine Anfrage mit draft: true, um eine günstige 480p-Vorschau zu erhalten; Entwürfe sind nur in 480p möglich und nicht mit einer Videobearbeitung kombinierbar. Ist der Entwurf erfolgreich, senden Sie eine zweite Anfrage mit model und draft_task_id, gesetzt auf die task_id des Entwurfs. Das Finalvideo wird in 1080p gerendert und übernimmt Prompt, Medien, Dauer, Seitenverhältnis, Seed und Audioeinstellung des Entwurfs. Außer model, draft_task_id, resolution und allgemeinen Feldern wie nsfw_check oder webhook ist kein Feld erlaubt: prompt, Medien, duration, aspect_ratio, seed, audio, omni_reference_task_type, return_last_frame, output_format oder enhance_prompt führen auch leer zu 400. Erstellen Sie das Finalvideo innerhalb von 24 Stunden: Eine draft_task_id, die nicht existiert, kein Entwurf ist, noch nicht fertig oder älter als 24 Stunden ist, führt zu 400. Entwurf und Finalvideo werden jeweils als eine Generierung berechnet; das Finalvideo wird mit 1080p und der Dauer des Entwurfs berechnet, bei einem Entwurf mit -1 mit dessen tatsächlicher Länge.

Fehler beim Absenden kommen als error-Objekt mit message, type, param und code zurück und werden nicht berechnet. 400 invalid_request_error umfasst ungültige Werte, Anzahl und Kombination von Medien (etwa erstes/letztes Frame mit Referenzmedien oder image_urls zusammen mit image_with_roles), Länge, Abmessungen, Seitenverhältnis oder Bildrate von Referenzvideos und Länge von Referenz-Audios außerhalb der Grenzen, Regeln für Aufgabentyp und Videobearbeitung, Werte von output_format, die Regeln für Entwurf und Finalvideo sowie nicht unterstützte Parameter wie negative_prompt oder camera_fixed. 400 input_video_probe_failed bedeutet, dass ein Referenzvideo nicht erreichbar ist oder seine Länge nicht ermittelt werden kann. 402 payment_required bedeutet zu wenig Guthaben; bei duration -1 oder einer Videobearbeitung werden 30 Sekunden reserviert. 400 nsfw_content_detected bedeutet, dass nsfw_check angeschlagen hat; message nennt die erkannten Kategorien. 503 draft_channel_unavailable oder draft_task_unavailable bedeutet, dass Entwürfe vorübergehend nicht verfügbar sind – versuchen Sie es später erneut oder erstellen Sie einen neuen Entwurf.

Ein Clip dauert meist 1–3 Minuten, fragen Sie daher alle 5–10 Sekunden ab. data.status ist pending, processing, completed oder failed, data.progress läuft von 0 bis 100. Die Video-URL in data.result.videos[0].url ist bei APIMart gespeichert und läuft 72 Stunden nach Fertigstellung ab – laden Sie das Video rechtzeitig herunter. Mit return_last_frame: true liefert data.result.last_frame_url zusätzlich das letzte Frame als png-Bild. Schlägt eine Aufgabe fehl, auch wenn die Registrierung der Medien nicht durchgeht oder die Prüfung von Bildabmessungen, Dateigröße oder Kodierung bei der Generierung scheitert, nennt data.error.message den Grund, data.error.code ist task_failed und data.cost ist 0, weil der reservierte Betrag automatisch erstattet wird.

Die apimart-zoe API wird pro Ausgabesekunde abgerechnet, mit Sätzen für 480p, 720p, 1080p, 2k und 4k und einem eigenen Satz für Anfragen mit Referenzvideo. Wenn Sie duration (4–30) setzen oder beim Standard 5 belassen, werden die angefragten Sekunden berechnet und nach Fertigstellung nicht an die Cliplänge angepasst. Bei duration -1 oder einer Videobearbeitung (omni_reference_task_type: edit) werden vorab 30 Sekunden reserviert und nach Abschluss auf die tatsächliche, auf ganze Sekunden gerundete Cliplänge abgerechnet; eine Videobearbeitung nutzt den Satz für Anfragen mit Referenzvideo. Mit Referenzvideo gilt: abgerechnete Sekunden = Videodauer + max(Gesamtlänge der Referenzvideos, ⌈Videodauer × 2/3⌉); die Referenzlänge wird beim Absenden pro Video gemessen, addiert, auf ganze Sekunden abgerundet und danach nicht mehr angepasst. Ein Finalvideo aus einem Entwurf wird mit 1080p und der Dauer des Entwurfs berechnet (bei einem Entwurf mit -1 dessen tatsächliche Länge) und zählt, falls der Entwurf ein Referenzvideo nutzte, auch dessen Länge. Ihr Betrag richtet sich nach Ihrem Mitglieds- oder Kontogruppenrabatt; siehe die Live-Preistabelle auf dieser Seite.

Auf APIMart nutzen beide Modelle POST /v1/videos/generations und GET /v1/tasks/{task_id}, erstellen 4–30 Sekunden lange Clips in Seitenverhältnissen von 21:9 bis 9:16, nehmen pro Anfrage bis zu 30 Referenzbilder, 10 Videos und 10 Audioclips an, unterstützen seed, Audiogenerierung, return_last_frame, output_format und Videobearbeitung (omni_reference_task_type: edit) und bieten den Ablauf vom 480p-Entwurf zum 1080p-Finalvideo. Die Unterschiede: apimart-zoe (Modell-ID apimart-zoe) gibt zusätzlich 2k und 4k aus, erlaubt keine ersten/letzten Frames zusammen mit Referenzmedien, verlangt bei Referenz-Audio ein Referenzbild oder -video und überlässt die Audio-Entscheidung dem Modell, wenn audio fehlt; bei Seedance 2.5 (seedance-2.5) ist generate_audio standardmäßig an, und das Modell unterstützt zusätzlich die Verlängerung (extend), die bei apimart-zoe noch nicht freigeschaltet ist. Mit Referenzvideo zählen die beiden Modelle die abgerechneten Sekunden außerdem unterschiedlich. Die Vergleichstabellen auf dieser Seite zeigen jeden Unterschied und die aktuellen Sekundenpreise.

Das hängt von der Auflösung ab und davon, ob Sie ein Referenzvideo senden. Der Preisvergleich auf dieser Seite zeigt die aktuellen Sekundenpreise beider Modelle mit und ohne Referenzvideo, den Unterschied in Prozent und Kostenbeispiele für gängige Cliplängen. Mit Referenzvideo addiert apimart-zoe max(abgerundete Gesamtsekunden der Referenzvideos, ⌈Ausgabesekunden × 2/3⌉) zu den Ausgabesekunden, Seedance 2.5 dagegen die Sekunden des Referenzvideos – vergleichen Sie also das Beispiel, das zu Ihrem Clip passt. apimart-zoe bietet außerdem 2k- und 4k-Stufen, die Seedance 2.5 nicht hat. Die Preise stammen aus der APIMart-Preis-API und hängen von Ihrer Mitgliedschaftsstufe ab.

Nein. Sie ist Pay-as-you-go und wird pro Ausgabesekunde abgerechnet; ein Entwurf und sein Finalvideo werden jeweils als eine Generierung berechnet. Fehler beim Absenden kosten nichts, bei zu wenig Guthaben kommt 402 zurück, und fehlgeschlagene Aufgaben werden automatisch erstattet, data.cost zeigt dann 0. Ihr Preis hängt von Ihrer Mitgliedschaftsstufe oder Kontogruppe ab; die Live-Preistabelle auf dieser Seite zeigt den aktuellen Satz je Auflösung.

Registrieren Sie sich bei APIMart, öffnen Sie im Dashboard die Seite API Keys, erstellen Sie einen Key und senden Sie ihn als Authorization: Bearer <key>. Derselbe Key ruft die apimart-zoe API und die anderen Modelle auf APIMart auf – mit Pay-as-you-go-Abrechnung und ohne Abonnement.