Zum Hauptinhalt springen
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

Authentifizierung

Authorization
string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungHolen Sie Ihren API Key:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API Key zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:
Authorization: Bearer YOUR_API_KEY

Anfrageparameter

model
string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • doubao-seedance-2.0 — Standardversion, unterstützt Text-zu-Video, Bild-zu-Video, Video aus erstem/letztem Frame, Referenzvideo, Referenzaudio und Video mit Audiospur
  • doubao-seedance-2.0-fast — Schnellversion, dieselben Funktionen wie die Standardversion bei höherer Generierungsgeschwindigkeit
  • doubao-seedance-2.0-face — unterstützt das Hochladen echter Personen, dieselben Funktionen wie die Standardversion
  • doubao-seedance-2.0-fast-face — unterstützt das Hochladen echter Personen, dieselben Funktionen wie die Schnellversion
prompt
string
Beschreibung des VideoinhaltsErforderlich für Text-zu-Video; optional für Bild-zu-Video oder Video-Referenz-zu-VideoEs wird empfohlen, Motiv, Aktion, Kamerabewegung und Stil klar anzugeben, um bessere Generierungsergebnisse zu erzielen
Der Prompt ist auf 4000 Zeichen begrenzt, empfohlen werden jedoch 500 Zeichen.
Beispiel: "A kitten yawning at the camera"
duration
integer
Standard:"5"
Videodauer (in Sekunden)Unterstützter Bereich: 4 bis 15 SekundenStandard: 5
size
string
Standard:"16:9"
Seitenverhältnis des VideosOptionen:
  • 16:9 — Querformat
  • 9:16 — Hochformat
  • 1:1 — Quadrat
  • 4:3 — Traditionelles Verhältnis
  • 3:4 — Vertikales traditionelles Verhältnis
  • 21:9 — Ultrabreit
  • adaptive — Adaptiv (passt sich automatisch an das eingegebene Bild/Video an)
Standard: 16:9
resolution
string
Standard:"480p"
VideoauflösungOptionen:
  • 480p — Standard Definition
  • 720p — High Definition
  • 1080p — Full HD (nur unterstützt von doubao-seedance-2.0-face und doubao-seedance-2.0)
Standard: 480p
seed
integer
Zufalls-Seed zur Steuerung der Zufälligkeit des generierten Inhalts
  • Bei derselben Anfrage erzeugen unterschiedliche Seed-Werte unterschiedliche Ergebnisse
  • Bei derselben Anfrage erzeugt derselbe Seed-Wert ähnliche Ergebnisse, exakte Konsistenz ist jedoch nicht garantiert
generate_audio
boolean
Standard:"false"
Ob Audio generiert werden soll (Video mit Audiospur)Wenn auf true gesetzt, enthält das Video von der KI generiertes BegleitaudioStandard: false
return_last_frame
boolean
Standard:"false"
Ob das Bild des letzten Frames zurückgegeben werden sollWenn auf true gesetzt, gibt das Aufgabenergebnis zusätzlich die URL des letzten Frames des Videos zurück, die für die kontinuierliche Videogenerierung verwendet werden kannStandard: false
tools
array<object>
Werkzeugliste für erweiterte Funktionen wie WebsucheBeispiel: [{"type": "web_search"}]
image_urls
array<string>
Array von Bild-URLs für Bild-zu-VideoUnterstützt zwei Formate:
  • Normale Bild-URL: https://example.com/cat.jpg
  • Asset-URL (genehmigtes Asset): asset://asset_a
Beispiel: ["https://example.com/cat.jpg"] oder ["asset://asset_a"]
Asset-URL wird nur von den Modellen doubao-seedance-2.0 und doubao-seedance-2.0-fast unterstützt. Andere Modelle unterstützen sie nicht.
  • image_urls und image_with_roles können nicht gleichzeitig verwendet werden
  • Maximal 9 Referenzbilder
image_with_roles
array
Bild-Array mit Rollen, unterstützt die Angabe von erstem Frame/letztem Frame
Wenn das Feld url eine Asset-URL verwendet, werden nur die Modelle doubao-seedance-2.0 und doubao-seedance-2.0-fast unterstützt. Andere Modelle unterstützen sie nicht.
Beispiel:
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
Asset-URL-Format:
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
  • image_urls und image_with_roles können nicht gleichzeitig verwendet werden
  • Bei Verwendung von Bildern des ersten/letzten Frames sind video_urls und audio_urls nicht verfügbar
video_urls
array<string>
Array von Referenzvideo-URLsUnterstützt zwei Formate:
  • Normale Video-URL: https://example.com/reference.mp4
  • Asset-URL (genehmigtes Asset): asset://asset_a
Beispiel: ["https://example.com/reference.mp4"] oder ["asset://asset_a"]
Asset-URL wird nur von den Modellen doubao-seedance-2.0 und doubao-seedance-2.0-fast unterstützt. Andere Modelle unterstützen sie nicht.
  • Bei Verwendung von Bildern des ersten/letzten Frames (image_with_roles) sind Referenzvideos nicht verfügbar
  • Maximal 3 Referenzvideos, Gesamtdauer maximal 15 Sekunden
  • Die Auflösung des Referenzvideos muss zwischen 480P und 720P liegen
  • Referenzvideos dürfen keine echten Personen enthalten
audio_urls
array<string>
Array von Referenzaudio-URLsUnterstützt zwei Formate:
  • Normale Audio-URL: https://example.com/speech.wav
  • Asset-URL (genehmigtes Asset): asset://asset_a
Beispiel: ["https://example.com/speech.wav"] oder ["asset://asset_a"]
Asset-URL wird nur von den Modellen doubao-seedance-2.0 und doubao-seedance-2.0-fast unterstützt. Andere Modelle unterstützen sie nicht.
  • Bei Verwendung von Bildern des ersten/letzten Frames (image_with_roles) ist Referenzaudio nicht verfügbar
  • Maximal 3 Referenzaudiodateien, Gesamtdauer maximal 15 Sekunden
  • Referenzaudio muss zusammen mit Referenzbildern oder Referenzvideos verwendet werden

Antwort

code
integer
Antwortstatuscode, 200 bei Erfolg
data
array
Array der Antwortdaten

Anwendungsfälle

Fall 1: Text-zu-Video

{
  "model": "doubao-seedance-2.0",
  "prompt": "A kitten yawning at the camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}

Fall 2: Bild-zu-Video (erster Frame)

{
  "model": "doubao-seedance-2.0",
  "prompt": "The kitten stands up and walks toward the camera",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}

Fall 3: Video aus erstem/letztem Frame

{
  "model": "doubao-seedance-2.0",
  "prompt": "Transition from day to night",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

Fall 4: Video aus Referenzvideo

{
  "model": "doubao-seedance-2.0",
  "prompt": "Convert the video style to anime style",
  "video_urls": ["https://example.com/reference.mp4"]
}

Fall 5: Referenzvideo + Referenzaudio

{
  "model": "doubao-seedance-2.0",
  "prompt": "A scene of a person speaking",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

Fall 6: Video mit Audiospur

{
  "model": "doubao-seedance-2.0",
  "prompt": "A man stops a woman and says: \"Remember, you must never point your finger at the moon.\"",
  "generate_audio": true
}

Fall 7: Kontinuierliche Videogenerierung (letzten Frame zurückgeben)

{
  "model": "doubao-seedance-2.0",
  "prompt": "The kitten continues walking toward the camera",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}

Fall 8: Generierung mit Schnellversion

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "City nightscape timelapse photography",
  "size": "21:9",
  "duration": 8
}

Fall 9: Referenzbilder + Referenzvideo + Referenzaudio (multimodales Video)

Kombinieren Sie Referenzbilder, Referenzvideo und Referenzaudio, um ein immersives Werbevideo aus der Ich-Perspektive zu erstellen. Ideal für Produktwerbung, Markenanzeigen und andere Szenarien, die das Zusammenführen von Materialien aus mehreren Quellen erfordern.
{
  "model": "doubao-seedance-2.0",
  "prompt": "Use video 1's first-person perspective throughout, and use audio 1 as the background music throughout. First-person POV fruit tea advertisement for seedance brand 'Peace Apple' apple fruit tea limited edition. First frame is image 1: your hand picks a dewy Aksu red apple with a crisp apple collision sound. 2-4s: quick cut, your hand drops apple chunks into a shaker cup, adds ice and tea base, shakes vigorously, ice collision and shaking sounds sync with upbeat drum beats, background voice: 'Fresh-cut, fresh-shaken'. 4-6s: first-person close-up of the finished product, layered fruit tea poured into a clear cup, your hand gently squeezes cream cap spreading on top, sticks a pink label on the cup, camera zooms in on the layered texture of cream cap and fruit tea. 6-8s: first-person handheld cup raise, you lift the fruit tea from image 2 toward the camera (simulating handing it to the viewer), cup label clearly visible, background voice 'Take a sip of freshness', final frame freezes on image 2. Background voice consistently uses a female tone.",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

Fall 10: Bild-zu-Video mit Asset-URL

Genehmigte Assets virtueller Avatare können direkt als Referenzbilder übergeben werden, ohne sie erneut hochladen oder prüfen lassen zu müssen.
{
  "model": "doubao-seedance-2.0",
  "prompt": "The character walks naturally on a city street under bright sunshine",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Fall 11: Referenz-Porträt mit Asset-URL angeben (image_with_roles)

{
  "model": "doubao-seedance-2.0",
  "prompt": "Using the reference portrait, the character walks elegantly toward the camera",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

Fall 12: Schnellversion + Asset-URL für Bild-zu-Video

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "The character strolls in a park with a gentle breeze",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Fall 13: Bild über Asset-URL + Referenzvideo (Bewegungsübertragung)

Kombinieren Sie ein genehmigtes Porträt-Asset mit einem Referenzvideo, um die Figur dazu zu bringen, bestimmte Bewegungen auszuführen.
{
  "model": "doubao-seedance-2.0",
  "prompt": "The character dances to the rhythm of the reference video with smooth and natural movements",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die bei der Einreichung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Fortschritt und die Ergebnisse der Generierung abzufragen.

Unterschiede zur Version 1.5 Pro

Funktion1.5 Pro2.0 / 2.0 fast
Auflösung480p/720p/1080p480p/720p
Dauerbereich4-12 s5-15 s
Standarddauer5 s5 s
Parameter für Seitenverhältnisaspect_ratiosize (neue Option adaptive)
Audio-GenerierungParameter audioParameter generate_audio
ReferenzvideoNicht unterstütztUnterstützt über video_urls
ReferenzaudioNicht unterstütztUnterstützt über audio_urls
Bild-zu-Videoimage_urls / image_with_rolesimage_urls / image_with_roles
Video mit AudiospurNicht unterstütztUnterstützt über generate_audio
Kontinuierliches VideoNicht unterstütztUnterstützt über return_last_frame
SchnellversionNicht unterstütztUnterstützt über doubao-seedance-2.0-fast