apimart-zoe Videogenerierung

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "apimart-zoe",
    "prompt": "Ein orangefarbenes Kätzchen auf der Fensterbank blickt zur Kamera, seitliches Sonnenlicht, die Kamera fährt langsam näher",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "apimart-zoe",
        "prompt": "Ein orangefarbenes Kätzchen auf der Fensterbank blickt zur Kamera, seitliches Sonnenlicht, die Kamera fährt langsam näher",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 8,
        "audio": True,
        "nsfw_check": True,
        "return_last_frame": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "apimart-zoe",
    "prompt": "Ein orangefarbenes Kätzchen auf der Fensterbank blickt zur Kamera, seitliches Sonnenlicht, die Kamera fährt langsam näher",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KZOEEXAMPLE"
    }
  ]
}

​

Modus wählen

​

Header

​

Anfrageparameter

​

Medienadressen und Kombinationsregeln

​

Prüfung der Referenzvideos

​

Regeln für Medienkombinationen

• image_urls und image_with_roles dürfen nicht gemeinsam gesendet werden. Andernfalls wird beim Absenden HTTP 400 (invalid_request_error) ohne Berechnung zurückgegeben. Die Aliasse image, images und image_url zählen als image_urls und umgehen diese Einschränkung nicht.
• Start-/Endbilder dürfen nicht in derselben Anfrage wie Referenzbilder, -videos oder -audio vorkommen.
• Je höchstens ein Start- und Endbild. Ein Endbild benötigt ein Startbild.
• Höchstens 30 Referenzbilder, 10 Referenzvideos und 10 Audioreferenzen, insgesamt höchstens 50 Medien.
• Verstöße gegen diese Kombinationen oder Anzahlen führen beim Absenden synchron zu HTTP 400 ohne Berechnung.
• omni_reference_task_type: "edit" erfordert mindestens ein Quellvideo (3.8 ≤ t < 30.2 Sekunden). duration / seconds nur weglassen oder -1; aspect_ratio / size nur weglassen oder adaptive. Nicht mit draft: true kombinieren. Auto/reference behalten die Grenze von 2–15 Sekunden samt Toleranz.

​

Anfragebeispiele

​

Start- und Endbilder

{
  "model": "apimart-zoe",
  "prompt": "Ein natürlicher Übergang vom Startbild zum Endbild bei gleichbleibender Beleuchtung",
  "image_with_roles": [
    {
      "url": "https://example.com/start.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/end.jpg",
      "role": "last_frame"
    }
  ],
  "duration": 6
}

​

Bild-, Video- und Audioreferenzen

{
  "model": "apimart-zoe",
  "prompt": "Die Figur aus dem Referenzbild bewegt sich natürlich in der Szene des Referenzvideos, begleitet von Musik im Rhythmus der Bilder",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/scene.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": -1
}

​

Videobearbeitung

{
  "model": "apimart-zoe",
  "prompt": "Das gesamte Bild in einen klassischen Schwarzweißfilm verwandeln und Kamerabewegung sowie Komposition beibehalten",
  "video_urls": [
    "https://example.com/source_20s.mp4"
  ],
  "omni_reference_task_type": "edit"
}

​

Letztes Frame, MOV-Ausgabe und Prompt-Optimierung

{
  "model": "apimart-zoe",
  "prompt": "Ein orangefarbenes Kätzchen auf der Fensterbank blickt zur Kamera, seitliches Sonnenlicht, die Kamera fährt langsam näher",
  "duration": 5,
  "return_last_frame": true,
  "output_format": "mov",
  "enhance_prompt": true
}

​

Entwurf → finales Video

1. Entwurf mit draft: true absenden. Ohne resolution wird 480p verwendet; bei expliziter Angabe ist ebenfalls nur 480p zulässig.

{
  "model": "apimart-zoe",
  "prompt": "Ein orangefarbenes Kätzchen auf der Fensterbank blickt zur Kamera, seitliches Sonnenlicht, die Kamera fährt langsam näher",
  "draft": true
}

2. Warten Sie auf den erfolgreichen Entwurf und übergeben Sie dessen task_id für das finale Video. model und draft_task_id genügen. Wenn Sie resolution angeben, muss es 1080p sein.

{
  "model": "apimart-zoe",
  "draft_task_id": "task_01KZOEEXAMPLE"
}

​

Aufgaben und Ergebnisse abrufen

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KZOEEXAMPLE \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task_01KZOEEXAMPLE",
    "status": "completed",
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "expires_at": 1794475442
        }
      ],
      "last_frame_url": "https://example.com/generated-last-frame.png"
    },
    "progress": 100,
    "completed": 1794389042
  }
}

​

Abrechnung

• Gesamtdauer der Referenzvideos R: beim Absenden jede Dauer ermitteln, addieren und die Summe auf ganze Sekunden abrunden. Keine spätere Anpassung.
• Ohne Referenzvideos: abrechenbare Sekunden = D. Mit Referenzvideos: D + max(R, ceil(D × 2/3)). ceil rundet auf ganze Sekunden auf. Es gilt der Tarif mit Referenzvideos.
• Beispiel: Angefragte 8 Sekunden bleiben D = 8, selbst bei 8.2 Sekunden Ergebnis. Automatische 8.5 Sekunden ergeben D = 9. Referenzen mit 2.8 und 3.8 Sekunden werden zuerst zu 6.6 addiert und dann abgerundet: R = 6.
• Entwurf (480p) und finales Video (1080p) werden separat berechnet. Referenzvideos des Entwurfs zählen mit ihrer ursprünglichen Dauer auch beim finalen Video; kein erneuter Upload nötig.
• Fehlgeschlagene Einreichungen werden nicht berechnet. Fehlgeschlagene Aufgaben werden automatisch erstattet.

​

Häufige Fehler