Seedance Metinden Videoya
Asenkron bir Görev oluşturmak için metinden videoya uç noktasını kullanın.
Genel Bakış
Metinden videoya uç noktasını desteklenen bir modelle kullanın. Durumunu almak için döndürülen Görev Kimliğini kullanın veya aşağıda belgelenen teslimler için callback_url sağlayın.
Hızlı başlangıç
- Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
- Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
- Döndürülen görev kimliğini saklayın, ardından bir terminal durumuna ulaşana kadar yoklama yapın ya da aşağıda belgelenen geri çağırmaları işleyin.
Uç Nokta
- Temel URL
https://runapi.ai- API sürümü
v1- Kimlik doğrulama
Authorization: Bearer YOUR_API_TOKEN
Desteklenen modeller
Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.
İstek şeması
Alanlar ve izin verilen değerler seçili modele göre değişir. Sağlandığında, callback_url aşağıda belgelenen Görev teslimatlarını alır.
seedance-1.5-pro11 alan
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 alan
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Aralık: 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 alan
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Aralık: 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 alan
aspect_ratiostring1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
callback_urlstringduration_secondsinteger5
Aralık: 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 alan
aspect_ratiostringÇıktı en boy oranı; auto seçeneği RunAPI'nin otomatik seçmesini sağlar.
İzin verilen değerler:1:1, 4:3, 3:4, 16:9, 9:16, 21:9, auto
Varsayılan: auto
callback_urlstringAsenkron görev güncellemeleri için webhook URL'si.
duration_secondsintegerSaniye cinsinden video süresi; -1 süreyi otomatik olarak seçer.
İzin verilen değerler:-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
Varsayılan: 5
enable_safety_checkerbooleanRunAPI'nin oluşturulan içeriği güvenlik açısından denetleyip denetlemediği.
first_frame_image_urlstringKare rehberli oluşturma için genel ilk kare görsel URL'si.
generate_audiobooleanSenkronize ses oluşturulup oluşturulmayacağı.
Varsayılan:true
last_frame_image_urlstringGenel son kare görsel URL'si; first_frame_image_url gerektirir.
modelstringRunAPI model tanımlayıcısı.
output_formatstringÇıktı video kapsayıcı biçimi.
İzin verilen değerler:mp4, mov
Varsayılan: mp4
output_resolutionstringÇıktı video çözünürlüğü.
İzin verilen değerler:480p, 720p, 1080p
Varsayılan: 720p
promptstringVideo oluşturma istemi.
Aralık:3 - 30000
reference_audio_urlsarrayGenel referans ses URL'leri; en fazla 10 ses dosyası.
Öğe sınırı:10
reference_image_urlsarrayGenel referans görsel URL'leri; en fazla 30 görsel.
Öğe sınırı:30
reference_video_urlsarrayGenel referans video URL'leri; en fazla 10 video.
Öğe sınırı:10
return_last_framebooleanOluşturulan videonun son karesinin döndürülüp döndürülmeyeceği.
Varsayılan:false
web_searchbooleanİstemin web aramasıyla zenginleştirilip zenginleştirilmeyeceği.
seedance-v1-pro10 alan
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 alan
callback_urlstringduration_secondsinteger5, 10
enable_safety_checkerbooleanfirst_frame_image_urlstringmodelstringoutput_resolutionstring720p, 1080p
promptstringseedinteger-1 - 2147483647
Koşullu kurallar
Bu gereksinimler, listelenen tüm koşulların eşleştiği durumlarda uygulanır.
-
Şu durumlarda
first_frame_image_url = {"present" => true},model = seedance-2.5- Gerekli
- Kabul edilmez
reference_image_urls,reference_video_urls,reference_audio_urls
-
Şu durumlarda
last_frame_image_url = {"present" => true},model = seedance-2.5- Gerekli
first_frame_image_url- Kabul edilmez
reference_image_urls,reference_video_urls,reference_audio_urls
-
Şu durumlarda
model = seedance-1.5-pro- Gerekli
- Kabul edilmez
first_frame_image_url,last_frame_image_url,reference_image_urls,reference_video_urls,reference_audio_urls,web_search,return_last_frame,output_format
-
Şu durumlarda
model = seedance-2-mini- Gerekli
- Kabul edilmez
source_image_urls,lock_camera,seed,enable_safety_checker,return_last_frame,output_format
-
Şu durumlarda
model = seedance-2.0- Gerekli
- Kabul edilmez
source_image_urls,lock_camera,seed,return_last_frame,output_format
-
Şu durumlarda
model = seedance-2.0-fast- Gerekli
- Kabul edilmez
source_image_urls,lock_camera,seed,return_last_frame,output_format
-
Şu durumlarda
model = seedance-2.5- Gerekli
- Kabul edilmez
source_image_urls,lock_camera,seed
-
Şu durumlarda
model = seedance-v1-pro- Gerekli
- Kabul edilmez
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
-
Şu durumlarda
model = seedance-v1-pro-fast- Gerekli
- Kabul edilmez
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
Kabul oluştur
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"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
}
Yanıt örneği
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}
Yoklama işleniyor
GET /api/v1/seedance/text_to_video/:id
Yanıt şeması
{
"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
}
Yanıt örneği
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}
Yoklama tamamlandı
GET /api/v1/seedance/text_to_video/:id
Yanıt şeması
{
"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
}
Yanıt örneği
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}
Yoklama başarısız oldu
GET /api/v1/seedance/text_to_video/:id
Yanıt şeması
{
"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
}
Yanıt örneği
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}
Müşteri geri çağırması: tamamlandı
POST callback_url
Yanıt şeması
{
"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
}
Yanıt örneği
{
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}
Müşteri geri çağırması: başarısız oldu
POST callback_url
Yanıt şeması
{
"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
}
Yanıt örneği
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "Authentication required"
}
Hatalar
GET /api/v1/seedance/text_to_video/:id
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "Authentication required"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"oneOf": [
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir doğrulama özeti.",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}
Yanıt örneği
{
"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"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "Insufficient balance"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "API key credit limit exceeded"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "The request uses features that are not supported for the selected model"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "Rate limit reached. Please retry later."
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "Service under maintenance, please try again later"
}
Hatalar
POST /api/v1/seedance/text_to_video
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "The request timed out"
}
Hatalar
GET /api/v1/seedance/text_to_video/:id
Yanıt şeması
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}
Yanıt örneği
{
"error": "Task with id 'tsk_reference_demo' not found"
}
Oluşturulan Kod Örnekleri
Doğrudan cURL kullanın veya diliniz için bir SDK yükleyin. Her örnek, bu başvuruda gösterilen doğrulanmış isteği gönderir.
Yükle
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."
)