Seedance 2.5 API

Vollständige API-Referenz für die Seedance 2.5-Videogenerierungsmodelle von ByteDance.

Modellvarianten

Diese API unterstützt drei Modellvarianten:

Kurzvergleich

Unterstützte Seitenverhältnisse

Text zu Video und Referenzen zu Video unterstützen:

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Bild zu Video unterstützt den Parameter aspect_ratio nicht.

Auflösungsoptionen

Seedance 2.5 Text to Video

Endpunkt

POST /api/v1/video/task

Anfrageparameter

Erforderlich

Optional

Beispielanfrage

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.5-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    resolution: '720p',
    duration: 8,
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.5 Image to Video

Anfrageparameter

Erforderlich

Optional

Fügen Sie aspect_ratio nicht in Bild-zu-Video-Anfragen ein. Dieses Modell unterstützt den Parameter nicht.

Beispielanfrage

javascriptKopieren
{
  model_name: 'seedance-v2.5-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  resolution: '720p',
  duration: 8,
  sound: true
}

Seedance 2.5 Reference to Video

Anfrageparameter

Erforderlich

Referenzmedien

Alle Referenzmedien sind optional. Anfragen nur mit Bildern, nur mit Videos, nur mit Audio sowie ohne Referenzmedien werden unterstützt. Für die Generierung ohne Referenzen wird Text zu Video empfohlen.

@ (AT)-Referenzplatzhalter

Die @ (AT)-Referenzfunktion verknüpft Referenzmedien über nummerierte <<<...>>>-Platzhalter mit dem Prompt. Die Nummerierung beginnt für jeden Medientyp unabhängig bei 1 und folgt der Reihenfolge des jeweiligen Arrays:

Wenn beispielsweise das erste Bild eine Figurenreferenz und das zweite eine Szenenreferenz ist, verwenden Sie in prompt <<<image_1>>> für die Figur und <<<image_2>>> für die Szene. Jeder Platzhalter muss auf ein tatsächlich vorhandenes Element im jeweiligen Array verweisen.

Optional

Beispielanfrage

javascriptKopieren
{
  model_name: 'seedance-v2.5-reference-to-video',
  prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere',
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

Beispielanfrage für Referenzen zu Video mit @ (AT)

javascriptKopieren
{
  model_name: 'seedance-v2.5-reference-to-video',
  prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
  resolution: '720p',
  duration: 10,
  aspect_ratio: '16:9',
  sound: true,
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.png'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

Medienlimits

Diese Limits gelten für Startbilder, Endbilder und Referenzmedien der Modelle auf dieser Seite.

Referenzaudio und Referenzvideos haben jeweils ein separates Gesamtdauerlimit von 30 Sekunden. Ihre Anzahlen sind unabhängig: bis zu 30 Bilder, 10 Videos und 10 Audioclips. Das Hinzufügen von Videos reduziert die zulässige Bildanzahl nicht.

Alle Modelle verwenden standardmäßig 720p, dennoch muss resolution angegeben werden. Der Tonschalter hat den Standardwert true; weder dieser Schalter noch Referenzaudio verändern den Preis.

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für Statusabfragen zurück:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Antwort auf Statusabfragen

Fragen Sie GET /api/v1/video/{taskId} ab, um den Status zu prüfen:

jsonKopieren
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Statuswerte

• submitted: Aufgabe angenommen und wartet auf Verarbeitung
• processing: Videogenerierung läuft
• succeed: Videogenerierung abgeschlossen
• failed: Videogenerierung fehlgeschlagen

Verarbeitungszeit

Die Verarbeitungszeit hängt von Dauer, Auflösung und aktueller Warteschlange ab.

Prüfen Sie den Status alle 5-10 Sekunden.

Bewährte Vorgehensweisen

1. Erforderliche Parameter: Geben Sie immer resolution und duration an, bei Text zu Video und Referenzen zu Video außerdem aspect_ratio
2. Seitenverhältnis bei Bild zu Video: Senden Sie bei Bild-zu-Video-Anfragen kein aspect_ratio
3. Referenzvideos: Videos sind optional; die Dauer jedes Videos und die Gesamtdauer müssen innerhalb der dokumentierten Limits liegen
4. Referenzbilder: Bilder sind unabhängig von Videos und Audio optional; übermitteln Sie bis zu 30 unterstützte Bild-URLs
5. Referenzaudio: Jeder Audioclip muss 2-30 Sekunden lang und höchstens 15 MB groß sein; die Gesamtdauer darf höchstens 30 Sekunden betragen
6. Referenzreihenfolge: Ordnen Sie images, videos und audios bewusst an und beziehen Sie sich im Prompt konsistent darauf
7. Ton: Lassen Sie sound weg, um den Standardwert true zu verwenden, oder setzen Sie es auf false, um die Tonerzeugung zu deaktivieren