Seedance Text zu Video
Verwenden Sie den Endpunkt „Text zu Video", um einen asynchronen Task zu erstellen.
Übersicht
Verwenden Sie den Endpunkt „Text zu Video" mit einem unterstützten Modell. Verwenden Sie die zurückgegebene Task-ID, um den Status abzurufen, oder geben Sie callback_url für die unten dokumentierten Zustellungen an.
Schnellstart
- Erstellen Sie einen API-Schlüssel und setzen Sie ihn als RUNAPI_API_KEY.
- Wählen Sie ein unterstütztes Modell und senden Sie eine POST-Anfrage, deren Body dem Schema dieses Modells entspricht.
- Speichern Sie die zurückgegebene Task-ID und fragen Sie den Status ab, bis ein Endzustand erreicht ist, oder verarbeiten Sie die unten dokumentierten Callbacks.
Endpunkt
- Basis-URL
https://runapi.ai- API-Version
v1- Authentifizierung
Authorization: Bearer YOUR_API_TOKEN
Unterstützte Modelle
Öffnen Sie eine Modellseite für aktuelle Preise, Ratenlimits und Details zur kommerziellen Nutzung.
Anfrage-Schema
Felder und zulässige Werte hängen vom ausgewählten Modell ab. Wenn angegeben, empfängt callback_url die unten dokumentierten Task-Zustellungen.
seedance-1.5-pro11 Felder
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9
callback_urlstringduration_secondsinteger4 - 12
enable_safety_checkerbooleangenerate_audiobooleanlock_camerabooleanmodelstringoutput_resolutionstring480p, 720p, 1080p
promptstringseedinteger-1 - 2147483647
source_image_urlsarray2
seedance-2-mini13 Felder
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Bereich: 4 - 15
first_frame_image_urlstringgenerate_audiobooleanlast_frame_image_urlstringmodelstringoutput_resolutionstring480p, 720p
promptstringreference_audio_urlsarray3
reference_image_urlsarray9
reference_video_urlsarray3
web_searchbooleanseedance-2.014 Felder
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Bereich: 4 - 15
enable_safety_checkerbooleanfirst_frame_image_urlstringgenerate_audiobooleanlast_frame_image_urlstringmodelstringoutput_resolutionstring480p, 720p, 1080p, 4k
promptstringreference_audio_urlsarray3
reference_image_urlsarray9
reference_video_urlsarray3
web_searchbooleanseedance-2.0-fast14 Felder
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Bereich: 4 - 15
enable_safety_checkerbooleanfirst_frame_image_urlstringgenerate_audiobooleanlast_frame_image_urlstringmodelstringoutput_resolutionstring480p, 720p
promptstringreference_audio_urlsarray3
reference_image_urlsarray9
reference_video_urlsarray3
web_searchbooleanseedance-2.516 Felder
aspect_ratiostringAusgabe-Seitenverhältnis; auto lässt RunAPI es auswählen.
Zulässige Werte:1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
Standard: auto
callback_urlstringWebhook-URL für asynchrone Task-Updates.
duration_secondsintegerVideodauer in Sekunden; -1 wählt die Dauer automatisch aus.
Zulässige Werte:-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
Standard: 5
enable_safety_checkerbooleanOb RunAPI generierten Inhalt auf Sicherheit prüft.
first_frame_image_urlstringÖffentliche Bild-URL des ersten Frames für die frame-geführte Generierung.
generate_audiobooleanOb synchronisiertes Audio generiert werden soll.
Standard:true
last_frame_image_urlstringÖffentliche Bild-URL des letzten Frames; erfordert first_frame_image_url.
modelstringRunAPI-Modellbezeichner.
output_formatstringAusgabe-Videocontainerformat.
Zulässige Werte:mp4, mov
Standard: mp4
output_resolutionstringAusgabe-Videoauflösung.
Zulässige Werte:480p, 720p, 1080p
Standard: 720p
promptstringPrompt zur Videogenerierung.
Bereich:3 - 30000
reference_audio_urlsarrayÖffentliche Referenzaudio-URLs; bis zu 10 Audiodateien.
Elementlimit:10
reference_image_urlsarrayÖffentliche Referenzbild-URLs; bis zu 30 Bilder.
Elementlimit:30
reference_video_urlsarrayÖffentliche Referenzvideo-URLs; bis zu 10 Videos.
Elementlimit:10
return_last_framebooleanOb das letzte Bild des generierten Videos zurückgegeben werden soll.
Standard:false
web_searchbooleanOb der Prompt durch eine Websuche angereichert werden soll.
seedance-v1-pro10 Felder
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9
callback_urlstringduration_secondsinteger5, 10
enable_safety_checkerbooleanfirst_frame_image_urlstringlock_camerabooleanmodelstringoutput_resolutionstring480p, 720p, 1080p
promptstringseedintegerseedance-v1-pro-fast8 Felder
callback_urlstringduration_secondsinteger5, 10
enable_safety_checkerbooleanfirst_frame_image_urlstringmodelstringoutput_resolutionstring720p, 1080p
promptstringseedinteger-1 - 2147483647
Bedingte Regeln
Diese Anforderungen gelten, wenn alle aufgeführten Bedingungen zutreffen.
-
Wenn
first_frame_image_url = {"present" => true},model = seedance-2.5- Erforderlich
- Nicht akzeptiert
reference_image_urls,reference_video_urls,reference_audio_urls
-
Wenn
last_frame_image_url = {"present" => true},model = seedance-2.5- Erforderlich
first_frame_image_url- Nicht akzeptiert
reference_image_urls,reference_video_urls,reference_audio_urls
-
Wenn
model = seedance-1.5-pro- Erforderlich
- Nicht akzeptiert
first_frame_image_url,last_frame_image_url,reference_image_urls,reference_video_urls,reference_audio_urls,web_search,return_last_frame,output_format
-
Wenn
model = seedance-2-mini- Erforderlich
- Nicht akzeptiert
source_image_urls,lock_camera,seed,enable_safety_checker,return_last_frame,output_format
-
Wenn
model = seedance-2.0- Erforderlich
- Nicht akzeptiert
source_image_urls,lock_camera,seed,return_last_frame,output_format
-
Wenn
model = seedance-2.0-fast- Erforderlich
- Nicht akzeptiert
source_image_urls,lock_camera,seed,return_last_frame,output_format
-
Wenn
model = seedance-2.5- Erforderlich
- Nicht akzeptiert
source_image_urls,lock_camera,seed
-
Wenn
model = seedance-v1-pro- Erforderlich
- Nicht akzeptiert
source_image_urls,last_frame_image_url,reference_image_urls,reference_video_urls,reference_audio_urls,web_search,generate_audio,return_last_frame,output_format
-
Wenn
model = seedance-v1-pro-fast- Erforderlich
- Nicht akzeptiert
aspect_ratio,source_image_urls,lock_camera,last_frame_image_url,reference_image_urls,reference_video_urls,reference_audio_urls,web_search,generate_audio,return_last_frame,output_format
Annahme erstellen
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
},
"task_replayed": {
"type": "boolean"
}
},
"required": [
"id",
"status",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}
Abfrage wird verarbeitet
GET /api/v1/seedance/text_to_video/:id
Antwort-Schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
}
},
"required": [
"id",
"status",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}
Abfrage abgeschlossen
GET /api/v1/seedance/text_to_video/:id
Antwort-Schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"last_frame_image_url": {
"type": "string",
"x-runapi-generated-media": true
},
"status": {
"enum": [
"completed"
],
"type": "string"
},
"videos": {
"items": {
"properties": {
"url": {
"type": "string",
"x-runapi-generated-media": true
}
},
"required": [
"url"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
}
},
"required": [
"id",
"status",
"videos",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}
Abfrage fehlgeschlagen
GET /api/v1/seedance/text_to_video/:id
Antwort-Schema
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"failed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"error",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}
Kunden-Callback: abgeschlossen
POST callback_url
Antwort-Schema
{
"properties": {
"id": {
"type": "string"
},
"last_frame_image_url": {
"type": "string",
"x-runapi-generated-media": true
},
"status": {
"enum": [
"completed"
],
"type": "string"
},
"videos": {
"items": {
"properties": {
"url": {
"type": "string",
"x-runapi-generated-media": true
}
},
"required": [
"url"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
}
},
"required": [
"id",
"status",
"videos"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}
Kunden-Callback: fehlgeschlagen
POST callback_url
Antwort-Schema
{
"properties": {
"error": {
"oneOf": [
{
"type": "string"
},
{
"properties": {
"code": {
"type": "string"
},
"limit_cents": {
"type": "integer"
},
"message": {
"type": "string"
},
"reset_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"used_cents": {
"type": "integer"
},
"window": {
"enum": [
"1h",
"1d",
"7d",
"daily",
"weekly",
"monthly",
"lifetime"
],
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"failed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "Authentication required"
}
Fehler
GET /api/v1/seedance/text_to_video/:id
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "Authentication required"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"oneOf": [
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "Menschenlesbare Validierungszusammenfassung.",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Validierungsmeldungen nach öffentlichem Anforderungsfeld gegliedert, mit einem Array menschenlesbarer Zeichenketten für jedes Feld.",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}
Antwortbeispiel
{
"error": "model must be one of: seedance-1.5-pro, seedance-2-mini, seedance-2.0, seedance-2.0-fast, seedance-2.5, seedance-v1-pro, seedance-v1-pro-fast"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "Insufficient balance"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "API key credit limit exceeded"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "The request uses features that are not supported for the selected model"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "Rate limit reached. Please retry later."
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "Service under maintenance, please try again later"
}
Fehler
POST /api/v1/seedance/text_to_video
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "The request timed out"
}
Fehler
GET /api/v1/seedance/text_to_video/:id
Antwort-Schema
{
"properties": {
"error": {
"description": "Für Menschen lesbare Fehlermeldung.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Antwortbeispiel
{
"error": "Task with id 'tsk_reference_demo' not found"
}
Generierte Code-Beispiele
Verwende cURL direkt oder installiere ein SDK für deine Programmiersprache. Jedes Beispiel übermittelt die in dieser Referenz gezeigte validierte Anfrage.
Installieren
pip install runapi-seedance
import os
from runapi.seedance import SeedanceClient
client = SeedanceClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.text_to_video.create(
model="seedance-1.5-pro",
duration_seconds=5,
prompt="A time-lapse of clouds moving over a mountain lake."
)