API-Dokumentation

Seedance API-Referenz

Vollständige API-Dokumentation zur Integration von Seedance Video AI in Ihre Anwendungen. Generieren Sie hochwertige Videos aus Textprompts und Bildern.

REST API

JSON-Antworten

Videogenerierung

Authentifizierung

Die Seedance API verwendet Bearer-Token-Authentifizierung. Fügen Sie Ihr API-Token in den Authorization-Header ein:

Authorization: Bearer your-api-token-here

Sicherheitshinweis: Geben Sie Ihr API-Token niemals in clientseitigem Code oder öffentlichen Repositories preis.

Basis-URL

Alle API-Anfragen sollten an folgende Adresse gesendet werden:

https://seedanceapi.org/v1

API-Endpunkte

POST

Video generieren

/generate

Generieren Sie hochwertige Videos aus Textprompts und Bildern mit KI-Modellen.

Anfragekörper

Text zu Video (T2V)

{
  "prompt": "cardi b bends over to pick up coins",
  "mode": "text",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1
}

Bild zu Video (I2V)

{
  "prompt": "kissing",
  "mode": "img2img",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1,
  "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}

Parameter

Parameter	Typ	Beschreibung
prompt	String	Textbeschreibung des zu generierenden Videos
mode	String	Generierungsmodus: "text" für T2V oder "img2img" für I2V
image_url	String?	Eingabebild-URL (erforderlich für img2img-Modus)
resolution	String	Videoauflösung: "480p", "720p" oder "1080p"
ratio	String	Video-Seitenverhältnis (Standard: "adaptive")
duration	Integer	Videodauer in Sekunden (Standard: 5)
framespersecond	Integer	Bilder pro Sekunde (Standard: 24)
seed	Integer	Zufalls-Seed für reproduzierbare Ergebnisse (Standard: -1)

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}

endpoints.generate.curl

Text zu Video (T2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cardi b bends over to pick up coins",
    "mode": "text",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1
  }'

Bild zu Video (I2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kissing",
    "mode": "img2img",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1,
    "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
  }'

GET

Aufgabenstatus abrufen

/status?task_id=xxxx

Überprüfen Sie den Status einer laufenden oder abgeschlossenen Videogenerierungsaufgabe.

Parameter

Parameter	Typ	Beschreibung
task_id	String	Aufgaben-ID, die vom Generierungsendpunkt zurückgegeben wurde

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 10,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "user_request": {
      "prompt": "A beautiful landscape with flowing water",
      "model": "seedance-video-v1",
      "duration": 5
    },
    "user_response": {
      "video_url": "https://cdn.seedance.com/generated/video.mp4",
      "last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
    },
    "provider_status": "success",
    "model": "seedance-video-v1"
  }
}

endpoints.generate.curl

curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

Fehlerbehandlung

Die Seedance API gibt standardmäßige HTTP-Statuscodes und Fehlermeldungen zurück:

HTTP-Statuscodes

200OK

400Bad Request

401Unauthorized

429Rate Limited

500Server Error

Fehlerantwortformat

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

Best Practice: Behandeln Sie Fehler immer elegant und überprüfen Sie HTTP-Statuscodes, bevor Sie den Antwortkörper verarbeiten.

Rate Limits

100

Anfragen/Minute

Kostenloser Plan

1000

Anfragen/Minute

Pro-Plan

5000

Anfragen/Minute

Enterprise

Rate-Limit-Header: Jede Antwort enthält X-RateLimit-Remaining und X-RateLimit-Reset Header zur Verfolgung Ihrer aktuellen Nutzung.

Bereit zum Entwickeln?

Holen Sie sich Ihren API-Schlüssel und erstellen Sie erstaunliche Videos mit Seedance

Loslegen Zurück zur Startseite