seedance2.5 API-Dokumentation — ByteDance über dreamtoai

seedance2.5

VideoByteDanceSeedance 2.5seedance2.5

Playground öffnen API-Keys verwalten

暂无模型描述

Authentifizierung

Base URL: https://api.dreamtoai.com
Authorization: Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Modellname (model): seedance2.5

Integrationsprotokoll

Warum dieses Protokoll

适合需要提交任务并轮询状态的图像、视频、音频生成工作流。

Endpunkt-URL

POST/v1/jobs

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

Request- / Response-JSON

Anfrage

{
  "model": "seedance2.5",
  "input": {
    "prompt": "电影感街头运镜，一辆跑车穿过雨夜霓虹街道",
    "first_frame_url": "https://example.com/first.png",
    "last_frame_url": "https://example.com/last.png",
    "reference_image_urls": [
      "https://example.com/ref.png"
    ],
    "reference_video_urls": [
      "https://example.com/ref.mp4"
    ],
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "seed": 12345,
    "callback_url": "https://example.com/webhook",
    "channel": "byte2.0"
  }
}

Antwort

{
  "id": "job_example",
  "object": "job",
  "status": "processing",
  "model": "seedance2.5",
  "created": 1710000000,
  "request_id": "req_example"
}

Request- / Response-Felder

Request-Felder

Feld	Typ	Erforderlich
prompt	string	Y
first_frame_url	image	N
last_frame_url	image	N
reference_image_urls	array	N
reference_video_urls	array	N
resolution	enum	N
duration	number	N
aspect_ratio	enum	N
seed	integer	N
callback_url	string	N
channel	string	N

Response-Felder

Feld	Typ	Erforderlich
id	string	N
status	enum	N
model	string	N
output.videos[].url	video	N
output.videos[].duration	number	N

Codebeispiele

cURLrequest.sh

curl -X POST "https://api.dreamtoai.com/v1/jobs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "seedance2.5",
  "input": {
    "prompt": "电影感街头运镜，一辆跑车穿过雨夜霓虹街道",
    "first_frame_url": "https://example.com/first.png",
    "last_frame_url": "https://example.com/last.png",
    "reference_image_urls": [
      "https://example.com/ref.png"
    ],
    "reference_video_urls": [
      "https://example.com/ref.mp4"
    ],
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "seed": 12345,
    "callback_url": "https://example.com/webhook",
    "channel": "byte2.0"
  }
}'

# cURL für den Referenz-Upload
curl -X POST "https://api.dreamtoai.com/v1/files/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "kind=video" \
  -F "purpose=reference" \
  -F "[email protected]"

# cURL für die Statusabfrage
# Ersetzen Sie job_example durch die task_id aus der Submit-Antwort.
curl -X GET "https://api.dreamtoai.com/v1/jobs/job_example" \
  -H "Authorization: Bearer YOUR_API_KEY"