Cách Sử Dụng Seedance 2.0 API Năm 2026

Ashley Innocent

Ashley Innocent

4 tháng 4 2026

Cách Sử Dụng Seedance 2.0 API Năm 2026

Tóm tắt

API Seedance 2.0 ra mắt vào ngày 2 tháng 4 năm 2026, thông qua Volcengine Ark. Bạn gửi một tác vụ tạo video bằng yêu cầu POST, sau đó thăm dò một endpoint GET cho đến khi trạng thái đạt "succeeded" (thành công). API hỗ trợ chuyển văn bản thành video, chuyển hình ảnh thành video, kiểm soát khung hình đầu và cuối, tham chiếu đa phương thức và tạo âm thanh gốc. Một video 1080p dài 5 giây có giá khoảng 0,93 đô la. Tải video trong vòng 24 giờ. URL sẽ hết hạn sau đó.

Hypereal AI

Giới thiệu

Vào ngày 2 tháng 4 năm 2026, nền tảng Volcengine Ark của ByteDance đã phát hành API Seedance 2.0 chính thức. Trước ngày đó, cách duy nhất để tạo video Seedance 2.0 là thông qua giao diện web. Nếu bạn đã xem các hướng dẫn minh họa cách sử dụng giao diện người dùng, thì những hướng dẫn đó được viết cho giao diện điều khiển. Hướng dẫn này bao gồm API thực mà các nhà phát triển có thể gọi theo chương trình.

💡
API tuân theo mô hình tác vụ không đồng bộ: Gửi yêu cầu POST để tạo tác vụ, nhận ID tác vụ, sau đó thăm dò một endpoint GET cho đến khi công việc hoàn tất. Mô hình đó đáng để thử nghiệm từ đầu đến cuối trước khi bạn triển khai. Các Kịch bản Kiểm thử của Apidog cho phép bạn chuỗi việc gửi POST, trích xuất ID tác vụ, lặp lại việc thăm dò GET và xác nhận rằng phản hồi cuối cùng chứa một URL video hợp lệ. Tải Apidog miễn phí để làm theo các bước kiểm thử trong phần Apidog bên dưới.

Bài viết này bao gồm mọi loại đầu vào được hỗ trợ, cách tính giá dựa trên số lượng token phản hồi và các lỗi bạn có thể gặp phải trong môi trường sản xuất.

Seedance 2.0 là gì?

Seedance 2.0 là một mô hình tạo video của ByteDance. Nó chạy trên Volcengine Ark với các ID mô hình doubao-seedance-2-0-260128 (tiêu chuẩn) và doubao-seedance-2-0-fast-260128 (nhanh hơn, chất lượng thấp hơn).

Mô hình này hỗ trợ nhiều loại đầu vào hơn so với phiên bản 1.5. Phiên bản 1.5 xử lý chuyển văn bản thành video và chuyển hình ảnh thành video. Phiên bản 2.0 bổ sung:

Mô hình xuất video 24 khung hình/giây với tỷ lệ khung hình từ 1:1 đến 21:9. Bạn chọn độ phân giải tại thời điểm yêu cầu.

Điều gì đã thay đổi: hướng dẫn so với API chính thức

Các bài viết trước đây về Seedance 2.0, bao gồm hướng dẫn tháng 2 năm 2026 trên trang web này, đã mô tả giao diện web Seedance 2.0 trên Volcengine. Vào thời điểm đó chưa có API. Những hướng dẫn đó đã chỉ ra cách điền vào trường lời nhắc trên một trang web và nhấp vào nút tạo.

Bản phát hành API vào ngày 2 tháng 4 năm 2026 đã thay đổi hoàn toàn điều đó. Giờ đây, bạn có thể gọi API từ bất kỳ ngôn ngữ nào, tự động hóa quy trình tạo video và tích hợp Seedance vào sản phẩm của riêng mình. Hướng dẫn này thay thế các hướng dẫn sử dụng giao diện người dùng cho mọi trường hợp sử dụng của nhà phát triển.

Điều kiện tiên quyết

Bạn cần có tài khoản Volcengine để bắt đầu. Tạo một tài khoản tại volcengine.com. Khi tài khoản của bạn đã hoạt động, hãy truy cập bảng điều khiển Ark tại:

https://console.volcengine.com/ark/region:ark+cn-beijing/apikey

Tạo một khóa API ở đó. Sau đó, xuất nó dưới dạng biến môi trường:

export ARK_API_KEY="your-api-key-here"

Mọi yêu cầu đến API đều sử dụng khóa này trong tiêu đề token Bearer:

Authorization: Bearer YOUR_ARK_API_KEY

Tài khoản mới sẽ nhận được tín dụng dùng thử miễn phí. Chúng đủ để tạo khoảng 8 video dài 15 giây ở độ phân giải 1080p trước khi bạn phải trả phí.

Chuyển văn bản thành video: yêu cầu đầu tiên của bạn

URL cơ sở cho tất cả các cuộc gọi API Seedance là:

https://ark.cn-beijing.volces.com/api/v3

Để gửi một tác vụ chuyển văn bản thành video, hãy gửi yêu cầu POST tới /v1/contents/generations/tasks.

Ví dụ cURL

curl -X POST "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
      }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

API trả về một ID tác vụ ngay lập tức:

{"id": "cgt-2025xxxxxxxx-xxxx"}

Ví dụ Python (SDK chính thức)

Trước tiên hãy cài đặt SDK:

pip install volcenginesdkarkruntime

Sau đó gửi một tác vụ:

import os
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

print(resp.id)

Lưu ID tác vụ. Bạn sẽ cần nó cho bước thăm dò.

Mô hình tác vụ không đồng bộ: gửi, thăm dò, tải xuống

Việc tạo Seedance không diễn ra ngay lập tức. Một video 1080p dài 5 giây thường mất từ 60 đến 120 giây. API xử lý điều này bằng một vòng đời tác vụ không đồng bộ:

queued -> running -> succeeded
                  -> failed
                  -> expired
                  -> cancelled

Bạn thăm dò endpoint GET cho đến khi trạng thái thay đổi từ queued (đang chờ) hoặc running (đang chạy).

Vòng lặp thăm dò Python hoàn chỉnh

import os
import time
import requests
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

# Step 1: submit
resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {"type": "text", "text": "Aerial shot of a mountain lake at sunrise, slow dolly forward"}
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

task_id = resp.id
print(f"Task submitted: {task_id}")

# Step 2: poll with exponential backoff
wait = 10
while True:
    result = client.content_generation.tasks.get(task_id=task_id)
    status = result.status
    print(f"Status: {status}")

    if status == "succeeded":
        video_url = result.content.video_url
        print(f"Video URL: {video_url}")
        break
    elif status in ("failed", "expired", "cancelled"):
        print(f"Task ended with status: {status}")
        break

    time.sleep(wait)
    wait = min(wait * 2, 60)  # cap at 60 seconds

# Step 3: download immediately
if status == "succeeded":
    response = requests.get(video_url, stream=True)
    with open("output.mp4", "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)
    print("Downloaded: output.mp4")

Việc chờ đợi theo cấp số nhân (exponential backoff) ngăn chặn việc gửi quá nhiều yêu cầu đến API. Giới hạn 60 giây giúp việc thăm dò đủ thường xuyên để sử dụng thực tế.

Chuyển hình ảnh thành video (I2V): tạo hoạt ảnh cho một hình ảnh tĩnh

Để tạo hoạt ảnh cho một hình ảnh, hãy thêm đối tượng image_url vào mảng content cùng với lời nhắc văn bản của bạn. Hình ảnh sẽ trở thành khung hình đầu tiên của video.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The woman slowly turns her head and smiles at the camera"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/portrait.jpg"}
        }
    ],
    ratio="adaptive",
    duration=5,
    watermark=False,
)

Đặt ratio thành "adaptive" báo cho mô hình biết sử dụng tỷ lệ khung hình gốc của hình ảnh đầu vào. Điều này tránh việc cắt xén hoặc tạo viền đen không mong muốn.

Mỗi hình ảnh phải dưới 30MB. Bạn có thể cung cấp tối đa 9 hình ảnh trong một yêu cầu duy nhất.

Khung hình đầu và cuối: kiểm soát điểm bắt đầu và kết thúc

Seedance 2.0 hỗ trợ kiểm soát khung hình đầu và cuối. Bạn cung cấp hình ảnh khung hình đầu tiên, hình ảnh khung hình cuối cùng và một lời nhắc văn bản. Mô hình sẽ tạo ra chuyển động ở giữa.

Điều này hữu ích cho các chuyển đổi sản phẩm, hiệu ứng biến hình hoặc bất kỳ chuỗi nào mà bạn biết trạng thái bắt đầu và kết thúc của mình.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The flower blooms from bud to full open, macro lens, soft light"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-bud.jpg"}
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-open.jpg"}
        }
    ],
    ratio="adaptive",
    duration=8,
    watermark=False,
)

Mô hình suy luận rằng hai hình ảnh có nghĩa là chế độ khung hình đầu và cuối khi cũng có một lời nhắc văn bản. Bao gồm cả hai hình ảnh theo thứ tự: khung hình đầu tiên trước, khung hình cuối cùng sau.

Bạn cũng có thể sử dụng return_last_frame: true khi tạo một clip. Điều này trả về một hình ảnh của khung hình cuối cùng cùng với URL video. Cung cấp hình ảnh đó làm khung hình đầu tiên cho yêu cầu tiếp theo của bạn để nối nhiều clip thành một chuỗi dài hơn.

Tham chiếu đa phương thức: kết hợp hình ảnh, video và âm thanh

Một trong những bổ sung mạnh mẽ nhất trong Seedance 2.0 là chấp nhận video và âm thanh làm đầu vào tham chiếu trong cùng một yêu cầu với hình ảnh và văn bản.

Mảng nội dung có thể chứa:

Giới hạn cho mỗi yêu cầu:

Một ví dụ tham chiếu kết hợp:

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "Match the visual style of the reference clip and add the provided background audio"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/style-reference.jpg"}
        },
        {
            "type": "video_url",
            "video_url": {"url": "https://example.com/motion-reference.mp4"}
        },
        {
            "type": "audio_url",
            "audio_url": {"url": "https://example.com/background-music.mp3"}
        }
    ],
    duration=10,
    ratio="16:9",
    watermark=False,
)

Khi bạn bao gồm một tham chiếu video, mức phí sẽ giảm xuống hạng V2V: khoảng 3,90 đô la cho mỗi triệu token thay vì 6,40 đô la.

Tạo âm thanh gốc

Đặt generate_audio: true để Seedance tạo một bản âm thanh cùng với video. Mô hình thực hiện việc tạo âm thanh-video kết hợp, do đó âm thanh khớp với hành động trên màn hình thay vì được thêm vào sau đó.

Việc tạo âm thanh bao gồm đối thoại, hiệu ứng âm thanh, tiếng ồn môi trường và nhạc nền. Đồng bộ hóa môi (lip sync) hoạt động với hơn 8 ngôn ngữ.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A street musician plays guitar outside a cafe in Paris, crowds passing by, city sounds"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=10,
    generate_audio=True,
    watermark=False,
)

Việc tạo âm thanh gốc làm tăng mức tiêu thụ token một chút so với video không có âm thanh. Hãy tính toán điều này vào ước tính chi phí của bạn.

Kiểm soát độ phân giải, tỷ lệ và thời lượng

Ba tham số định hình đầu ra:

resolution chấp nhận "480p", "720p", "1080p" hoặc "2K". Mặc định là "1080p". Độ phân giải cao hơn có nghĩa là tiêu thụ nhiều token hơn và chi phí cao hơn.

ratio chấp nhận "16:9", "9:16", "4:3", "3:4", "21:9", "1:1" hoặc "adaptive". Sử dụng "adaptive" khi hình ảnh đầu vào của bạn có tỷ lệ khung hình bất thường. Mô hình đọc kích thước hình ảnh và đặt tỷ lệ tương ứng.

duration chấp nhận các số nguyên từ 4 đến 15. Đơn vị là giây. Mặc định là 5. Video dài hơn có chi phí tăng theo tỷ lệ.

Mô hình nhanh (doubao-seedance-2-0-fast-260128) tạo ra chất lượng thấp hơn nhưng hoàn thành nhanh hơn. Sử dụng nó để tạo mẫu thử hoặc khi bạn đang lặp lại các lời nhắc. Chuyển sang mô hình tiêu chuẩn để có đầu ra sản xuất.

Khi nào nên chọn Seedance 2.0 thay vì các API video khác: chọn Seedance khi bạn cần tạo video-âm thanh kết hợp gốc, kiểm soát khung hình đầu và cuối hoặc đầu vào tham chiếu đa phương thức. Nếu bạn chỉ cần chuyển văn bản thành video đơn giản và chi phí là ưu tiên hàng đầu, mô hình nhanh ở độ phân giải 480p là lựa chọn rẻ nhất trong phân khúc này.

Đọc chi phí từ phản hồi

Sau khi một tác vụ thành công, phản hồi bao gồm trường usage:

{
  "usage": {
    "completion_tokens": 246840,
    "total_tokens": 246840
  }
}

Mức tiêu thụ token tương quan với độ dài và độ phân giải của video. Một điểm tham chiếu từ tài liệu chính thức: một video 1080p dài 15 giây tiêu thụ khoảng 308.880 token. Một video 1080p dài 5 giây sử dụng khoảng 102.960 token.

Giá cho T2V và I2V ở độ phân giải 1080p là 46 nhân dân tệ cho mỗi triệu token (khoảng 6,40 đô la cho mỗi triệu token theo tỷ giá hối đoái hiện tại).

Ước tính nhanh:

Đối với các tác vụ V2V (yêu cầu bao gồm tham chiếu video), mức giá giảm xuống còn 28 nhân dân tệ cho mỗi triệu token (khoảng 3,90 đô la cho mỗi triệu token).

Bạn có thể kiểm tra số lượng token chính xác trên mỗi phản hồi và tích hợp tính năng theo dõi chi phí vào ứng dụng của mình. Nhân completion_tokens với mức giá cho loại tác vụ của bạn.

Quan trọng: tải video trong vòng 24 giờ

video_url trong phản hồi thành công trỏ đến bộ nhớ đối tượng của Volcengine. URL đó sẽ hết hạn sau 24 giờ kể từ khi tác vụ thành công. Sau thời gian đó, URL sẽ trả về lỗi 403 và tệp sẽ biến mất.

Luôn tải tệp về bộ nhớ của riêng bạn ngay sau khi trạng thái thay đổi thành succeeded (thành công). Vòng lặp thăm dò trong phần trước đã bao gồm bước tải xuống này như một phần của quy trình chuẩn.

Trường execution_expires_after xác nhận thời gian hết hạn tính bằng giây. 172800 có nghĩa là 48 giờ đối với bản ghi tác vụ. URL video vẫn hết hạn sau 24 giờ bất kể. Hãy tin vào quy tắc 24 giờ.

Lịch sử tác vụ cũng được giới hạn trong 7 ngày gần nhất. Bạn không thể truy vấn các tác vụ cũ hơn thời gian đó.

Cách kiểm thử API Seedance bằng Apidog

Mô hình tác vụ không đồng bộ có hai cuộc gọi API phụ thuộc lẫn nhau. Bạn không thể viết một kiểm thử duy nhất cho nó. Các Kịch bản Kiểm thử của Apidog xử lý điều này bằng một quy trình chuỗi.

Dưới đây là thiết lập chính xác:

Bước 1: Tạo một Kịch bản Kiểm thử

Trong Apidog, vào mô-đun Tests (Kiểm thử) và tạo một kịch bản mới có tên "Tạo video Seedance 2.0". Đặt biến môi trường ARK_API_KEY của bạn trong cài đặt môi trường của Apidog. Sử dụng {{ARK_API_KEY}} ở bất cứ đâu bạn muốn tham chiếu khóa.

Bước 2: Thêm yêu cầu gửi (submit)

Thêm bước yêu cầu POST tùy chỉnh tới https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks. Đặt tiêu đề Authorization thành Bearer {{ARK_API_KEY}}. Thêm phần thân JSON của bạn với các trường model và content.

Sau bước này, thêm một bộ xử lý Extract Variable (Trích xuất Biến). Đặt nó để trích xuất từ phần thân phản hồi bằng biểu thức JSONPath $.id. Lưu giá trị vào một biến môi trường có tên TASK_ID.

Bước 3: Thêm bộ xử lý Wait (Chờ)

Chèn một bộ xử lý Wait sau bước trích xuất. Đặt thời gian chờ là 30 giây. Điều này cho phép mô hình có thời gian bắt đầu xử lý trước khi bạn thử thăm dò lần đầu tiên.

Bước 4: Thêm yêu cầu thăm dò trong một vòng lặp For

Thêm một khối điều khiển vòng lặp For với tối đa 20 lần lặp. Bên trong vòng lặp:

  1. Thêm bước yêu cầu GET tới https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{{TASK_ID}} với cùng tiêu đề Authorization.
  2. Thêm một bộ xử lý Wait với độ trễ 10 giây sau yêu cầu GET.
  3. Đặt điều kiện Break If (Dừng Nếu) của vòng lặp: $.status == "succeeded" hoặc $.status == "failed".

Bước 5: Thêm các xác nhận

Sau khi vòng lặp kết thúc, thêm một bộ xử lý Assertion (Xác nhận) kiểm tra:

Chạy kịch bản và Apidog tạo một báo cáo kiểm thử đầy đủ hiển thị từng bước, ID tác vụ được trích xuất, tất cả các phản hồi thăm dò và liệu các xác nhận cuối cùng có được thông qua hay không.

Bạn cũng có thể nhập trực tiếp các endpoint Seedance từ lệnh cURL vào các bước kịch bản kiểm thử. Cách tiếp cận này hoạt động tốt khi bạn muốn nhanh chóng thêm các yêu cầu gửi và thăm dò mà không cần nhập thủ công mọi tiêu đề và tham số.

Phân tích chi phí: giá một video 10 giây

API Seedance sử dụng giá token trả theo mức sử dụng. Không có giới hạn số người dùng hàng tháng hoặc tín dụng để quản lý ngoài số dư dùng thử ban đầu.

Loại tác vụ Giá (mỗi 1 triệu token)
T2V / I2V ở 1080p 46 nhân dân tệ (khoảng 6,40 đô la)
V2V (đầu vào tham chiếu video) 28 nhân dân tệ (khoảng 3,90 đô la)

Chi phí ước tính cho các thời lượng phổ biến ở độ phân giải 1080p:

Thời lượng Token ước tính Chi phí (T2V/I2V)
5 giây ~103.000 ~0,66 nhân dân tệ / ~0,93 đô la
10 giây ~206.000 ~9,48 nhân dân tệ / ~1,32 đô la
15 giây ~309.000 ~14,21 nhân dân tệ / ~1,97 đô la

Tài khoản mới bắt đầu với tín dụng dùng thử miễn phí đủ cho khoảng 8 lần tạo video 15 giây hoàn chỉnh. Sử dụng số tín dụng này để thử nghiệm với các lời nhắc và cài đặt trước khi đưa vào khối lượng công việc sản xuất.

Độ phân giải thấp hơn làm giảm đáng kể mức tiêu thụ token. Một video 480p với cùng thời lượng có chi phí thấp hơn đáng kể so với 1080p. Bắt đầu phát triển ở 720p, sau đó nâng cấp độ phân giải chỉ cho đầu ra cuối cùng của bạn.

Các lỗi thường gặp và cách khắc phục

429 Quá nhiều yêu cầu

Điều này có nghĩa là bạn đã đạt đến giới hạn đồng thời, không phải giới hạn tốc độ yêu cầu mỗi phút. Quá nhiều tác vụ đang chạy cùng một lúc. Sử dụng cơ chế chờ đợi theo cấp số nhân (exponential backoff) khi bạn thấy mã trạng thái này. Bắt đầu với thời gian chờ 10 giây và nhân đôi nó trong mỗi lần thử lại, giới hạn ở 60 giây. Vòng lặp thăm dò được trình bày ở phần trước bao gồm mô hình này.

trạng thái: "failed" (thất bại)

Một tác vụ thất bại có nghĩa là mô hình không thể tạo video. Các nguyên nhân phổ biến: lời nhắc chứa nội dung vi phạm bộ lọc an toàn, hình ảnh đầu vào bị hỏng hoặc quá lớn, hoặc sự kết hợp các tham số không hợp lệ. Kiểm tra các tệp đầu vào và lời nhắc của bạn, sau đó gửi lại.

trạng thái: "expired" (đã hết hạn)

Một tác vụ hết hạn nếu nó nằm trong hàng đợi quá lâu mà không hoàn thành. Điều này có thể xảy ra trong thời gian tải cao điểm. Gửi lại tác vụ. Không có cách nào để khởi động lại một tác vụ đã hết hạn.

Lỗi 403 trên video_url

URL đã hết hạn. Khoảng thời gian 24 giờ đã trôi qua trước khi bạn tải tệp. Bản ghi tác vụ vẫn có thể tồn tại trong API trong tối đa 7 ngày, nhưng tệp video đã biến mất. Bạn sẽ cần tạo lại nó bằng cách sử dụng cùng các tham số và giá trị seed nếu bạn đã lưu nó.

Khả năng tái tạo Seed

Nếu bạn đã lưu giá trị seed từ một phản hồi trước đó, hãy truyền nó trở lại trong yêu cầu tiếp theo với cùng các tham số. Mô hình sẽ cố gắng tái tạo cùng một đầu ra. Điều này hữu ích cho việc tạo lại các video đã hết hạn với kết quả giống hệt.

Kết luận

API Seedance 2.0 cung cấp cho bạn quyền truy cập theo chương trình vào một trong những mô hình tạo video mạnh mẽ nhất hiện có ngày nay. Mô hình tác vụ không đồng bộ rất đơn giản: POST để tạo tác vụ, thăm dò cho đến khi thành công, tải xuống ngay lập tức. Các đầu vào đa phương thức, tạo âm thanh gốc và kiểm soát khung hình đầu cuối giúp xây dựng các quy trình làm việc video mà trước đây không thể thực hiện được từ giao diện web.

Thiết lập phạm vi kiểm thử của bạn trong Apidog trước khi bạn đưa vào sản xuất. Chuỗi Kịch bản Kiểm thử sẽ phát hiện logic thăm dò bị lỗi, các bước trích xuất bị thiếu và các vấn đề hết hạn URL trước khi chúng ảnh hưởng đến người dùng thực.

button

Câu hỏi thường gặp

Hỏi: Sự khác biệt giữa doubao-seedance-2-0-260128 và doubao-seedance-2-0-fast-260128 là gì?

Mô hình tiêu chuẩn tạo ra đầu ra chất lượng cao hơn và là mặc định cho sản xuất. Mô hình nhanh hoàn thành công việc nhanh hơn với chất lượng hình ảnh thấp hơn. Sử dụng mô hình nhanh khi lặp lại các lời nhắc và chuyển sang tiêu chuẩn cho các kết xuất cuối cùng.

Hỏi: Tôi có thể sử dụng Seedance 2.0 bên ngoài Trung Quốc không?

Endpoint API được đặt tại khu vực Bắc Kinh. Các nhà phát triển bên ngoài Trung Quốc có thể gọi nó, nhưng độ trễ sẽ cao hơn. Kiểm tra điều khoản dịch vụ của Volcengine để biết bất kỳ hạn chế địa lý nào đối với loại tài khoản của bạn.

Hỏi: Làm cách nào để nối nhiều clip thành một video dài hơn?

Đặt return_last_frame: true cho mỗi lần tạo. Phản hồi sẽ bao gồm một hình ảnh của khung hình cuối cùng cùng với URL video. Truyền hình ảnh đó làm khung hình đầu tiên của yêu cầu tiếp theo của bạn. Lặp lại cho đến khi bạn có tất cả các clip cần thiết, sau đó ghép chúng lại bằng thư viện chỉnh sửa video.

Hỏi: Tạo âm thanh gốc có tốn kém hơn không?

Tạo âm thanh gốc làm tăng mức tiêu thụ token một chút vì mô hình chạy việc tạo âm thanh-video kết hợp thay vì chỉ video. Mong đợi một sự gia tăng khiêm tốn về completion_tokens so với cùng một yêu cầu mà không có generate_audio: true.

Hỏi: Tôi có thể thiết lập webhook thay vì thăm dò không?

Có. Truyền tham số callback_url trong yêu cầu gửi của bạn. API sẽ gửi (POST) kết quả tác vụ đã hoàn thành đến URL đó khi trạng thái thay đổi. Điều này hiệu quả hơn việc thăm dò đối với các quy trình có khối lượng lớn.

Hỏi: Điều gì xảy ra nếu tôi vượt quá giới hạn 9 hình ảnh?

API trả về lỗi xác thực 400 trước khi tác vụ được tạo. Giảm số lượng hình ảnh trong mảng nội dung của bạn xuống 9 hoặc ít hơn.

Hỏi: Tham số seed có đảm bảo tái tạo chính xác cùng một video không?

Tham số seed giúp đầu ra có khả năng tái tạo cao hơn. Không đảm bảo tái tạo chính xác nếu các tham số khác nhau hoặc phiên bản mô hình phía máy chủ thay đổi. Đây là phương pháp gần đúng nhất hiện có.

Hỏi: Làm cách nào để theo dõi chi tiêu trên nhiều tác vụ?

Đọc trường completion_tokens từ phản hồi của mỗi tác vụ và nhân với mức giá token của gói dịch vụ của bạn. Ghi lại các giá trị này vào cơ sở dữ liệu để theo dõi chi phí. Không có bảng điều khiển chi tiêu tích hợp sẵn trong API, vì vậy hãy xây dựng hệ thống theo dõi của riêng bạn ngay từ đầu.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API