Seedance 2.0 Videoerzeugung | API-Dokumentation

# Seedance 2.0 Video Generation

Seedance 2.0 text, first/last-frame, multimodal, and audio generation parameters.

POST https://api.apihop.ai/v1/video/seedance

Create an asynchronous Seedance 2.0 job. For Seedance 2.5, use its [separate parameter reference](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-5).

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Body

### `model` (string, required)

`seedance-2.0` or its alias `seedance-2-0`.

### `prompt` (string)

Video prompt. Required for text-only generation; may be omitted or blank when image or video references are supplied. Audio alone is not a valid input. Text items inside `metadata.content` are discarded; only this top-level prompt is used.

### `seconds` (string, Default: 5)

Integer string from `"4"` through `"15"`. The numeric `duration` alias is also accepted. If both are supplied, they must agree. Automatic duration (`-1`) is not supported.

### `size` (string, Default: 720p)

Output resolution: `480p`, `720p`, `1080p`, or `4k`. Not an aspect ratio. Resolution precedence: `metadata.resolution`, `size`, then `resolution`.

### `aspectRatio` (string, Default: 16:9)

`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, or `adaptive`. `aspect_ratio` and `ratio` are aliases; `metadata.ratio` takes precedence. Use one alias for each setting.

### `metadata` (object)

Accepts `resolution`, `ratio`, `content`, and `generate_audio`. Set `generate_audio` to a boolean to control generated audio. Top-level `generateAudio` / `generate_audio` are aliases; supply only one audio control.

### `images` (string[])

Image shorthand: the first image is the first frame and the second is the last frame. For precise roles, use `metadata.content`. Existing `imageUrls`, `imageUrl`, `image_urls`, and `image_url` aliases remain accepted with the same frame semantics.

### `imageWithRoles` (object[])

Images with `url` and `role`: `first_frame`, `last_frame`, or `reference_image`. `image_with_roles` is an alias. Both versions also accept typed `metadata.content`.

### `videoUrls` (string[])

Reference videos. `videoUrl`, `video_urls`, and `video_url` are aliases.

### `audioUrls` (string[])

Reference audio. `audioUrl`, `audio_urls`, and `audio_url` are aliases. Requires an image or video reference in the same request.

### `callback_url` (string)

Optional native callback URL. Availability depends on the selected channel; use `GET https://api.apihop.ai/v1/jobs/{jobId}` as the authoritative result.

## Multimodal Content

Each `metadata.content` media item contains its matching nested URL object. Media URLs may use public HTTP(S) URLs or existing `asset://` identifiers.

| Type | URL field | Roles |
| --- | --- | --- |
| `image_url` | `image_url.url` | `first_frame`, `last_frame`, `reference_image` |
| `video_url` | `video_url.url` | `reference_video` |
| `audio_url` | `audio_url.url` | `reference_audio` |

Up to 9 images, 3 videos, and 3 audio files are accepted, including shorthand and typed content. Audio requires an image or video. `draft_task` is not supported. Use top-level `prompt` instead of `type: "text"` content items. Top-level `first_frame_url`, `last_frame_url`, `reference_image_urls`, `reference_video_urls`, and `reference_audio_urls` are role-specific shorthand. Unlisted fields inside content items are not forwarded.

Unsupported controls such as `negativePrompt`, `seed`, `returnLastFrame`, `nsfwCheck`, `tools`, `webhook`, `watermark`, `outputFormat`, and their snake-case aliases are rejected. `width`, `height`, `fps`, `cfgScale`, `steps`, and `style` are not supported.

## Request Examples

### Text-to-Video

```json
{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}
```

### First and Last Frames

```json
{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}
```

### Image and Audio References

```json
{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}
```

## Submission and Result

Response `data` contains `jobId`, `status`, `model`, and `message`. Submission success means the job was accepted, not completed. Poll `GET https://api.apihop.ai/v1/jobs/{jobId}` with the same account's API Key. See [Get Async Job](https://apihop.ai/en/docs/api-reference/jobs).

When status is `COMPLETED`, read `data.outputResult`. Accept both a string `url` and an array of URLs in each result object. Charges depend on actual completion tokens and output resolution; video references select the video-input rate, while image/audio-only references do not.

Erstellen Sie einen asynchronen Seedance-2.0-Auftrag. Für Seedance 2.5 verwenden Sie die separate Parameterreferenz.

Authentifizierung

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Anfragekörper

modelstringerforderlich

seedance-2.0 oder der Alias seedance-2-0.

promptstring

Videoprompt. Für reine Texterzeugung erforderlich; bei Bild- oder Videoreferenzen darf er fehlen oder leer sein. Audio allein ist keine gültige Eingabe. Textelemente in metadata.content werden verworfen; nur dieser oberste Prompt wird verwendet.

secondsstringStandard: 5

Ganzzahl als Zeichenfolge von "4" bis "15". Der numerische Alias duration wird ebenfalls akzeptiert. Werden beide angegeben, müssen sie übereinstimmen. Automatische Dauer (-1) wird nicht unterstützt.

sizestringStandard: 720p

Ausgabeauflösung: 480p, 720p, 1080p oder 4k. Kein Seitenverhältnis. Vorrang der Auflösung: metadata.resolution, dann size, dann resolution.

aspectRatiostringStandard: 16:9

16:9, 9:16, 1:1, 4:3, 3:4, 21:9 oder adaptive. aspect_ratio und ratio sind Aliasse; metadata.ratio hat Vorrang. Verwenden Sie je Einstellung einen Alias.

metadataobject

Akzeptiert resolution, ratio, content und generate_audio. Setzen Sie generate_audio auf einen booleschen Wert, um erzeugtes Audio zu steuern. Die obersten Felder generateAudio / generate_audio sind Aliasse; geben Sie nur eine Audiosteuerung an.

imagesstring[]

Bildkurzform: Das erste Bild ist das erste, das zweite das letzte Videobild. Verwenden Sie für genaue Rollen metadata.content. Die bestehenden Aliasse imageUrls, imageUrl, image_urls und image_url werden mit derselben Bildrollenbedeutung weiterhin akzeptiert.

imageWithRolesobject[]

Bilder mit url und role: first_frame, last_frame oder reference_image. image_with_roles ist ein Alias. Beide Versionen akzeptieren auch typisierte metadata.content.

videoUrlsstring[]

Referenzvideos. videoUrl, video_urls und video_url sind Aliasse.

audioUrlsstring[]

Referenzaudio. audioUrl, audio_urls und audio_url sind Aliasse. Erfordert eine Bild- oder Videoreferenz in derselben Anfrage.

callback_urlstring

Optionale native Callback-URL. Die Verfügbarkeit hängt vom gewählten Kanal ab; verwenden Sie GET https://api.apihop.ai/v1/jobs/{jobId} als maßgebliches Ergebnis.

Multimodale Inhalte

Jedes Medienelement in metadata.content enthält das zugehörige verschachtelte URL-Objekt. Medien-URLs können öffentliche HTTP(S)-URLs oder vorhandene asset://-Kennungen sein.

Typ	URL-Feld	Rollen
`image_url`	`image_url.url`	`first_frame`, `last_frame`, `reference_image`
`video_url`	`video_url.url`	`reference_video`
`audio_url`	`audio_url.url`	`reference_audio`

Bis zu 9 Bilder, 3 Videos und 3 Audiodateien werden einschließlich Kurzformen und typisierter Inhalte akzeptiert. Audio erfordert ein Bild oder Video. draft_task wird nicht unterstützt. Verwenden Sie den obersten prompt statt Inhaltselementen mit type: "text". Die obersten Felder first_frame_url, last_frame_url, reference_image_urls, reference_video_urls und reference_audio_urls sind rollenspezifische Kurzformen. Nicht aufgeführte Felder innerhalb von Inhaltselementen werden nicht weitergeleitet.

Nicht unterstützte Steuerungen wie negativePrompt, seed, returnLastFrame, nsfwCheck, tools, webhook, watermark, outputFormat und deren snake_case-Aliasse werden abgelehnt. width, height, fps, cfgScale, steps und style werden nicht unterstützt.

Anfragebeispiele

Text zu Video

json

{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}

Erstes und letztes Bild

json

{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}

Bild- und Audioreferenzen

json

{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}

Übermittlung und Ergebnis

Die Antwort data enthält jobId, status, model und message. Erfolgreiche Übermittlung bedeutet Annahme, nicht Abschluss des Auftrags. Fragen Sie GET https://api.apihop.ai/v1/jobs/{jobId} mit dem API-Schlüssel desselben Kontos ab. Siehe Asynchronen Auftrag abrufen.

Lesen Sie bei Status COMPLETED den Wert data.outputResult. Akzeptieren Sie in jedem Ergebnisobjekt sowohl eine Zeichenfolge url als auch ein Array von URLs. Die Kosten richten sich nach tatsächlichen Fertigstellungstokens und Ausgabeauflösung; Videoreferenzen wählen den Videoeingabetarif, reine Bild-/Audioreferenzen dagegen nicht.