Dokumentation API-Referenz SDK-Referenz Agentic-Nutzung KI-Skills

Videos

Videogenerierung anfordern

Sendet einen asynchronen Videogenerierungs-Job. Antwortet sofort mit 202 und einer Job-ID (Präfix vjob_); pollen Sie GET /api/v1/videos/{id}, bis status completed ist, und laden Sie dann über unsigned_urls herunter. Abrechnung: Guthaben wird beim Senden aus duration × resolution reserviert und bei Abschluss nach tatsächlich gelieferten Sekunden abgerechnet (usage.cost in der Poll-Antwort).

POST/api/v1/videos

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Body

modelerforderlich

string

Die ID des Videogenerierungsmodells (mit Provider-Präfix).

Example: "alibaba/wan2.7-t2v"

prompterforderlich

string

Der Text-Prompt, der das zu generierende Video beschreibt.

duration

integer

Videolänge in Sekunden. Standard: 2. Jedes Modell hat engere Grenzen — z. B. erlaubt Reference-to-Video (r2v) 2–10 s; Werte außerhalb geben 400 zurück, bevor Guthaben reserviert wird.

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

Ausgabequalitätsstufe, Standard "720p". Unterstützte Stufen variieren je Modell; eine nicht unterstützte Stufe gibt 400 zurück, bevor Guthaben reserviert wird, und der Fehler listet die unterstützten Stufen auf.

480p720p1080p

Example: "720p"

aspect_ratio

string

Seitenverhältnis. Übliche Werte: "16:9", "9:16", "1:1", "4:3", "3:4"; der genaue Satz hängt vom Modell ab (einige akzeptieren auch Breitformate wie "21:9"). Nicht unterstützte Kombinationen geben 400 zurück, bevor Guthaben reserviert wird; Modi mit Eingabe-Frame leiten das Verhältnis vom Frame ab und ignorieren dieses Feld.

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

Erste/letzte Keyframe-Bilder (Image-to-Video, Keyframe-to-Video). Akzeptiert URL-Strings oder Objekte { type: "image", image_url: { url }, frame_type: "first" | "last" }.

input_references

object[] | string[]

Referenz-Assets (Reference-to-Video): steuern die Generierung mit Referenzelementen — bevorzugt in Objektform { type: "image", image_url: { url } } (URL-Strings werden ebenfalls akzeptiert und als Bildreferenzen behandelt). Bildreferenzen sind am breitesten unterstützt; Audio-/Video-Referenzobjekte werden unverändert weitergereicht und wirken nur auf Modellen, die sie unterstützen — andere Modelle nutzen nur die Bildreferenzen. Nur Modelle mit r2v-Modus akzeptieren dieses Feld.

input_video

string | object

Quellvideo (nur Video-Edit-Modelle; ein BazaarLink-Erweiterungsfeld). Akzeptiert einen URL-String, { video_url: { url } } oder { url }. Von Nicht-Edit-Modellen ignoriert. Bearbeitung wird nach Quellsekunden + gelieferten Ausgabesekunden abgerechnet.

generate_audio

boolean

Ob auch Audio generiert werden soll. Nur bei audiofähigen Modellen wirksam; Sekunden mit Audio haben einen höheren Sekundensatz.

watermark

boolean

Ob die Ausgabe ein Wasserzeichen erhält. Standard: false — BazaarLink deaktiviert Standard-Wasserzeichen aktiv, sofern Sie nicht explizit true übergeben.

seed

number

Sampling-Seed. Reproduzierbarkeitsgarantien variieren je nach Modell.

callback_url

string

Eine Webhook-URL, die beim Erreichen des Endzustands des Jobs aufgerufen wird, damit Sie nicht pollen müssen. Nur HTTPS, und SSRF-geprüft (private/interne Adressen werden abgelehnt), bevor Guthaben reserviert wird. Wird genau einmal ausgelöst, nur von der Anfrage, die die Bestimmung des Endzustands gewinnt; die Zustellung wird bei Fehlschlag wiederholt (2 Versuche, 2s/8s Backoff), und erschöpfte Wiederholungen wirken sich nie auf die Abrechnung oder den tatsächlichen Status des Jobs aus. Keine Signatur in v1 — behandeln Sie den Callback als Hinweis und bestätigen Sie Status/Betrag durch Aufruf von GET /v1/videos/{id} mit Ihrem API-Schlüssel, bevor Sie handeln. ⚠️ unsigned_urls im Webhook-Payload sind absolute URLs, anders als die relativen Pfade des Poll-Endpunkts.

https:// only, ≤2048 chars

Detailguide →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Antwortbeispiele

Job angenommen (asynchron). Pollen Sie die zurückgegebene polling_url (d. h. GET /api/v1/videos/{id}); ein Intervall von ≥5 s wird empfohlen.

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}