Seedance Zamiana tekstu na wideo
Użyj punktu końcowego text to video, aby utworzyć asynchroniczne zadanie.
Omówienie
Użyj punktu końcowego text to video z obsługiwanym modelem. Użyj zwróconego identyfikatora zadania, aby pobrać jego stan, lub podaj callback_url dla dostarczeń udokumentowanych poniżej.
Szybki start
- Utwórz klucz API i ustaw go jako RUNAPI_API_KEY.
- Wybierz obsługiwany model i wyślij żądanie POST, którego treść odpowiada schematowi tego modelu.
- Zapisz zwrócony identyfikator zadania, a następnie odpytuj do momentu osiągnięcia stanu końcowego lub obsłuż wywołania zwrotne opisane poniżej.
Punkt końcowy
- Bazowy URL
https://runapi.ai- Wersja API
v1- Uwierzytelnianie
Authorization: Bearer YOUR_API_TOKEN
Obsługiwane modele
Otwórz stronę modelu, aby zapoznać się z aktualnymi cenami, limitami żądań i szczegółami dotyczącymi użytku komercyjnego.
Schemat żądania
Pola i dozwolone wartości zależą od wybranego modelu. Jeśli zostanie podany, callback_url będzie odbierać dostarczenia zadań (Task) opisane poniżej.
seedance-1.5-pro11 pola
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 pola
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Zakres: 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 pola
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Zakres: 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 pola
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Zakres: 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 pola
aspect_ratiostringWspółczynnik proporcji danych wyjściowych; auto pozwala RunAPI dokonać wyboru.
Dozwolone wartości:1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
Domyślna wartość: auto
callback_urlstringURL webhooka dla asynchronicznych aktualizacji zadań.
duration_secondsintegerCzas trwania wideo w sekundach; -1 powoduje automatyczny dobór czasu trwania.
Dozwolone wartości:-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
Domyślna wartość: 5
enable_safety_checkerbooleanCzy RunAPI sprawdza wygenerowane treści pod kątem bezpieczeństwa.
first_frame_image_urlstringPubliczny adres URL obrazu pierwszej klatki do generowania kierowanego klatką.
generate_audiobooleanCzy generować zsynchronizowane audio.
Domyślna wartość:true
last_frame_image_urlstringPubliczny adres URL obrazu ostatniej klatki; wymaga first_frame_image_url.
modelstringIdentyfikator modelu RunAPI.
output_formatstringFormat kontenera wideo wyjściowego.
Dozwolone wartości:mp4, mov
Domyślna wartość: mp4
output_resolutionstringRozdzielczość wideo wyjściowego.
Dozwolone wartości:480p, 720p, 1080p
Domyślna wartość: 720p
promptstringPrompt generowania wideo.
Zakres:3 - 30000
reference_audio_urlsarrayPubliczne adresy URL referencyjnych plików audio; do 10 plików audio.
Limit elementów:10
reference_image_urlsarrayPubliczne adresy URL referencyjnych obrazów; do 30 obrazów.
Limit elementów:30
reference_video_urlsarrayPubliczne adresy URL referencyjnych wideo; do 10 wideo.
Limit elementów:10
return_last_framebooleanCzy zwracać ostatnią klatkę wygenerowanego wideo.
Domyślna wartość:false
web_searchbooleanCzy wzbogacać prompt za pomocą wyszukiwania w sieci.
seedance-v1-pro10 pola
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 pola
callback_urlstringduration_secondsinteger5, 10
enable_safety_checkerbooleanfirst_frame_image_urlstringmodelstringoutput_resolutionstring720p, 1080p
promptstringseedinteger-1 - 2147483647
Reguły warunkowe
Te wymagania obowiązują, gdy spełnione są wszystkie wymienione warunki.
-
Kiedy
first_frame_image_url = {"present" => true},model = seedance-2.5- Wymagane
- Nie jest akceptowane
reference_image_urls,reference_video_urls,reference_audio_urls
-
Kiedy
last_frame_image_url = {"present" => true},model = seedance-2.5- Wymagane
first_frame_image_url- Nie jest akceptowane
reference_image_urls,reference_video_urls,reference_audio_urls
-
Kiedy
model = seedance-1.5-pro- Wymagane
- Nie jest akceptowane
first_frame_image_url,last_frame_image_url,reference_image_urls,reference_video_urls,reference_audio_urls,web_search,return_last_frame,output_format
-
Kiedy
model = seedance-2-mini- Wymagane
- Nie jest akceptowane
source_image_urls,lock_camera,seed,enable_safety_checker,return_last_frame,output_format
-
Kiedy
model = seedance-2.0- Wymagane
- Nie jest akceptowane
source_image_urls,lock_camera,seed,return_last_frame,output_format
-
Kiedy
model = seedance-2.0-fast- Wymagane
- Nie jest akceptowane
source_image_urls,lock_camera,seed,return_last_frame,output_format
-
Kiedy
model = seedance-2.5- Wymagane
- Nie jest akceptowane
source_image_urls,lock_camera,seed
-
Kiedy
model = seedance-v1-pro- Wymagane
- Nie jest akceptowane
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
-
Kiedy
model = seedance-v1-pro-fast- Wymagane
- Nie jest akceptowane
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
Tworzenie akceptacji
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"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
}
Przykład odpowiedzi
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}
Odpytywanie w toku
GET /api/v1/seedance/text_to_video/:id
Schemat odpowiedzi
{
"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
}
Przykład odpowiedzi
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}
Odpytywanie zakończone
GET /api/v1/seedance/text_to_video/:id
Schemat odpowiedzi
{
"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
}
Przykład odpowiedzi
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}
Odpytywanie nie powiodło się
GET /api/v1/seedance/text_to_video/:id
Schemat odpowiedzi
{
"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
}
Przykład odpowiedzi
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}
Wywołanie zwrotne klienta: ukończono
POST callback_url
Schemat odpowiedzi
{
"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
}
Przykład odpowiedzi
{
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}
Wywołanie zwrotne klienta: niepowodzenie
POST callback_url
Schemat odpowiedzi
{
"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
}
Przykład odpowiedzi
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "Authentication required"
}
Błędy
GET /api/v1/seedance/text_to_video/:id
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "Authentication required"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"oneOf": [
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "Czytelne dla człowieka podsumowanie walidacji.",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Komunikaty walidacyjne identyfikowane przez publiczne pole żądania, z tablicą czytelnych dla człowieka ciągów znaków dla każdego pola.",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}
Przykład odpowiedzi
{
"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"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "Insufficient balance"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "API key credit limit exceeded"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "The request uses features that are not supported for the selected model"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "Rate limit reached. Please retry later."
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "Service under maintenance, please try again later"
}
Błędy
POST /api/v1/seedance/text_to_video
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "The request timed out"
}
Błędy
GET /api/v1/seedance/text_to_video/:id
Schemat odpowiedzi
{
"properties": {
"error": {
"description": "Czytelny dla człowieka komunikat o błędzie.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Przykład odpowiedzi
{
"error": "Task with id 'tsk_reference_demo' not found"
}
Wygenerowane przykłady kodu
Używaj bezpośrednio cURL lub zainstaluj SDK dla swojego języka. Każdy przykład przesyła zwalidowane żądanie pokazane w tej dokumentacji.
Instalacja
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."
)