Seedance 2.0
Seedance 2.0
Tai lieuBat dau
Tong quan APIVan ban thanh videoHinh anh thanh video
Tai lieu tham khao API

Tong quan API

Hieu ro xac thuc, gui job, kiem tra trang thai va webhook trong Seedance 2.0 Open API.

Seedance 2.0 Open API cho phep ban gui cac job tao video bat dong bo tu san pham cua minh va lay ket qua khi qua trinh xu ly hoan tat.

Base URL

https://www.seedance2.ink

Authentication

Tat ca request Open API deu su dung Bearer token duoc tao trong dashboard Seedance.

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Luong tich hop

  1. Tao API Key trong dashboard Seedance.
  2. Gui job bang POST /api/open/v1/video/generations.
  3. Luu lai requestId duoc tra ve.
  4. Polling GET /api/open/v1/video/generations/{requestId} cho den khi dat trang thai cuoi.
  5. Neu can, hay dung webhook de nhan thong bao khi job hoan tat.

Endpoint chinh

MethodEndpointDescription
GET/api/open/v1/modelsLiet ke model, thoi luong, ti le, do phan giai va thong tin gia co san.
POST/api/open/v1/video/generationsTao job tao video moi.
GET/api/open/v1/video/generations/{requestId}Kiem tra trang thai job va tra ve URL dau ra khi san sang.
POST/api/open/v1/video/generations/{requestId}/cancelHuy job dang cho hoac dang duoc xu ly.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

Trang thai

StatusDescription
queuedRequest da duoc chap nhan va dang cho trong hang doi.
processingQua trinh tao dang duoc xu ly.
succeededJob da hoan tat thanh cong va output.url da san sang.
failedJob that bai. Hay kiem tra error.
cancelledJob da bi huy truoc khi hoan tat.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

Ban co the dat webhookUrl cho tung request hoac cau hinh URL callback mac dinh o cap API Key.

  • Neu ca hai cung ton tai, webhookUrl trong request se duoc uu tien.
  • Neu co cau hinh Webhook Secret, header x-seedance-signature se duoc gui kem.
  • Webhook chi duoc gui khi job dat trang thai cuoi.
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

Ma loi

HTTP statusError codeDescription
400invalid_requestNoi dung request khong khop schema mong doi.
401unauthorizedAPI Key thieu hoac khong hop le.
402insufficient_creditsKhong du credit de tao job.
404not_foundKhong tim thay job cho API Key hien tai.
429rate_limitedVuot qua gioi han moi phut hoac quota hang thang.
500internal_errorDa xay ra loi noi bo khong mong doi.

Buoc tiep theo

  • Doc Van ban thanh video
  • Doc Hinh anh thanh video

Bat dau

Cach nhanh nhat de bat dau su dung Seedance 2.0 hieu qua.

Van ban thanh video

Tao video tu prompt van ban voi Seedance 2.0 Open API.

Mục lục

Base URLAuthenticationLuong tich hopEndpoint chinhAvailable ModelsTrang thaiModels Endpoint ExampleWebhookMa loiBuoc tiep theo