curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
seedance-2-5-flash
Seedance 2.5 Flash Videogenerierung
Erstellen Sie bis zu 30 Sekunden lange Videos in 480p / 720p aus Text, multimodalen Referenzen, durch Bearbeitung, Verlängerung oder Start- und Endbilder.
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
POST /v1/videos/generations, lesen Sie data[0].task_id und fragen Sie anschließend GET /v1/tasks/{task_id} ab.
Verwenden Sie
Authorization: Bearer <token>. <token> ist Ihr APIMart-API-Schlüssel.Anfrageparameter
Verwenden Sie
seedance-2-5-flash. Auch doubao-seedance-2-5-flash wird akzeptiert. Der Name mit Punkt seedance-2.5-flash wird nicht unterstützt.Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
true: Prompts und Eingabebilder mitomni-moderation-latestprüfenfalseoder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
nsfw_content_detected), ohne Aufgabe oder Generierungskosten. Referenzvideos und Audio werden nicht geprüft. Bei Ausfall der Moderation kann die Anfrage fortgesetzt werden.Erforderlicher Prompt. Referenzieren Sie Medien mit
@图片1 / @视频1 / @音频1. Die Indizes beginnen bei 1 und folgen der Reihenfolge im jeweiligen Medienarray.Nur
480p / 720p; Standard: 720p. Werte wie 1080p, 2k oder 4k führen beim Senden zu HTTP 400.16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (Standard). Alias: aspect_ratio. Start-/Endbild-, Bearbeitungs- und Verlängerungsaufgaben erfordern adaptive.Ganze Sekunden
4–30; normale Anfragen verwenden ohne Angabe 5. -1 bedeutet automatisch. Explizites edit erlaubt nur -1 oder keine Angabe; Letzteres wird zu -1, die Dauer folgt dem Quellvideo. Automatische Dauer reserviert 30 Sekunden und wird nach tatsächlichen Tokens abgerechnet.Ton erzeugen, standardmäßig
true. Alias: audio. Steuert den Ausgabeton unabhängig von den Eingabereferenzen audio_urls.auto (Standard), reference, edit oder extend, nur mit Referenzmedien. Explizite Typen aktivieren die unten beschriebenen Prüfungen beim Senden.Referenzbilder, alle als
reference_image behandelt. Zusammen mit image_with_roles maximal 10 Bilder. Für Start- und Endbilder verwenden Sie image_with_roles.Jedes Element enthält
url und role. Rollen: reference_image, first_frame (maximal 1), last_frame (maximal 1, mit Startbild). Zusammen mit image_urls maximal 10 Bilder; vermeiden Sie widersprüchliche Rollen. Bei video_urls / audio_urls werden Start-/Endbilder als multimodale Referenzbilder behandelt.Maximal 5 Referenzvideos, jeweils 2–30 Sekunden, insgesamt höchstens 30 Sekunden. Quellvideos zur Bearbeitung müssen 4–30 Sekunden lang sein.
Maximal 5 Audioreferenzen, jeweils 2–30 Sekunden, insgesamt höchstens 30 Sekunden. Reine Audioreferenzen ohne Bild oder Video werden unterstützt.
Mit
true wird nach Erfolg ein Endbild unter data.result.videos[].last_frame_url zurückgegeben.draft / draft_task_id werden nicht unterstützt. Entfernen Sie diese Felder, sonst wird beim Senden HTTP 400 zurückgegeben. Für Entwürfe verwenden Sie Seedance 2.5.Medienanforderungen
Verwenden Sie öffentlich erreichbarehttp(s)-URLs oder freigegebene asset://-IDs. Ausgabeauflösung und Pixelgrenzen der Eingabevideos werden getrennt geprüft.
| Medium | Grenzen |
|---|---|
| Bilder | Zusammen ≤10 in beiden Bildfeldern; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; Breite und Höhe jeweils 300–6000 px; Verhältnis 0.4–2.5; jeweils <30 MB. |
| Videos | ≤5; MP4 / MOV mit H.264 / H.265 und AAC / MP3; jeweils 2–30 Sekunden, insgesamt ≤30 Sekunden; jeweils ≤200 MB; Breite und Höhe 300–6000 px, Verhältnis 0.4–2.5, Breite × Höhe 409,600–8,295,044 Pixel, 24–60 FPS. |
| Audio | ≤5; WAV / MP3; jeweils 2–30 Sekunden, insgesamt ≤30 Sekunden; jeweils ≤15 MB. |
Aufgabentypen und Einschränkungen
| Modus | Verwendung und Einschränkungen |
|---|---|
| Text zu Video | prompt ohne Referenzmedien; omni_reference_task_type weglassen. |
| Referenzen zu Video | Referenzmedien angeben; reference ist optional. Normale Dauer- und Formatgrenzen gelten weiterhin. |
| Start-/Endbilder | image_with_roles verwenden; size / aspect_ratio muss adaptive sein. |
| Videobearbeitung | edit; mindestens 1 Quellvideo mit 4–30 Sekunden; Verhältnis adaptive, duration nur -1 oder weglassen. |
| Videoverlängerung | extend; mindestens 1 Referenzvideo; Verhältnis adaptive. |
auto bestimmt das Modell den Typ anhand von Medien und Prompt; Einschränkungen können daher erst während der Generierung zum Fehler führen. Auch ein expliziter Typ kann bei widersprüchlichem Prompt mit InvalidParameter.TaskTypeMismatch scheitern.
Anfragebeispiele
Multimodale Referenz
{
"model": "seedance-2-5-flash",
"prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
"image_urls": [
"https://example.com/reference.jpg"
],
"video_urls": [
"https://example.com/reference_8s.mp4"
],
"audio_urls": [
"https://example.com/music_5s.mp3"
],
"omni_reference_task_type": "reference",
"duration": 8,
"size": "16:9"
}
Start- und Endbilder
{
"model": "seedance-2-5-flash",
"prompt": "Smoothly transition from the first frame to the last frame",
"image_with_roles": [
{
"url": "https://example.com/first.jpg",
"role": "first_frame"
},
{
"url": "https://example.com/last.jpg",
"role": "last_frame"
}
],
"size": "adaptive",
"duration": 5
}
Videobearbeitung
{
"model": "seedance-2-5-flash",
"prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "edit",
"size": "adaptive",
"duration": -1,
"output_format": "mov"
}
Videoverlängerung
{
"model": "seedance-2-5-flash",
"prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "extend",
"size": "adaptive",
"duration": 5
}
Private Medien
Bilder oder Videos mit echten Gesichtern müssen zuerst in der Medienbibliothek freigegeben werden; danach verwenden Sieasset://. Setzen Sie auch beim Upload model auf seedance-2-5-flash. Siehe Medienbibliothek-API; verwenden Sie den Flash-Namen im folgenden Beispiel.
curl --request POST \
--url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"group": {
"name": "flash-assets"
},
"asset_type": "Image",
"assets": [
{
"url": "https://example.com/reference.jpg",
"name": "reference"
}
]
}'
asset://-ID aus der Medienliste und verwenden sie in image_urls, image_with_roles[].url, video_urls oder audio_urls.
Aufgabenstatus und Ergebnisse
Fragen Sie die Status-API ab.pending / processing: läuft; completed: erfolgreich; failed: fehlgeschlagen. Lesen Sie data.result.videos[0].url[0]; url ist ein Array.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
--header 'Authorization: Bearer <token>'
{
"code": 200,
"data": {
"id": "task_example_seedance25flash",
"status": "completed",
"progress": 100,
"cost": 0.3104,
"credits_cost": 3.104,
"usage": {
"completion_tokens": 38800
},
"result": {
"videos": [
{
"url": [
"https://example.com/generated-video.mp4"
],
"last_frame_url": "https://example.com/generated-last-frame.png"
}
]
}
}
}
| Feld | Bedeutung |
|---|---|
data.usage.completion_tokens | Tokens für die endgültige Abrechnung. Kann nach Abschluss einige Sekunden fehlen; erneut abfragen. |
data.cost | Tatsächlicher Betrag in USD nach Kontorabatten. Maßgeblich ist der Rückgabewert. |
data.credits_cost | Tatsächlich abgezogene Credits. |
data.result.videos[].url | Video-URL-Array; zeitnah herunterladen und speichern. |
data.result.videos[].last_frame_url | Endbild-URL, nur nach Erfolg mit angefordertem return_last_frame: true. |
data.error.message | Fehlergrund. Fehlgeschlagene Aufgaben haben data.cost: 0; die Reservierung wird erstattet. |
Abrechnung
- Beim Senden wird anhand des Sekundenpreises der Auflösung reserviert. Mit Referenzvideo gilt der Eingabetarif für Ausgabedauer plus gesamte Referenzvideodauer.
- Normale Anfragen ohne
durationreservieren 5 Ausgabesekunden.duration: -1odereditohne Dauer reserviert 30 Ausgabesekunden. - Nach Erfolg:
data.usage.completion_tokens÷ 1,000,000 × passender Preis je Million Tokens, mit Kontorabatten. Die Differenz wird erstattet oder nachberechnet. Je nach Referenzvideo gilttokenodertoken-input; der endgültige Betrag steht indata.cost. - Abgewiesene Anfragen verursachen keine Generierungskosten. Bei Generierungsfehlern wird die Reservierung erstattet. Preise und Rabatte siehe Preisseite.
Häufige Fehler
| Situation | Maßnahme |
|---|---|
| HTTP 400: Auflösung nicht unterstützt | Nur 480p / 720p, nicht 1080p. |
| HTTP 400: zu viele Referenzen | Maximal 10 Bilder insgesamt, 5 Videos und 5 Audioclips; auch Dauer prüfen. |
| HTTP 400: Entwurf nicht unterstützt | draft / draft_task_id entfernen. |
| HTTP 400: Typ, Dauer oder Verhältnis | Kombination von omni_reference_task_type, duration, size / aspect_ratio prüfen. |
HTTP 400: nsfw_content_detected | Als Moderationsablehnung behandeln, error.message lesen und Inhalt ändern. |
| Modell nicht gefunden | seedance-2-5-flash statt seedance-2.5-flash verwenden. |
Aufgabe failed | data.error.message lesen; Medien und Prompt auf den Typ abstimmen. Die Reservierung wird erstattet. |