API tối ưu câu lệnh Seedance

Dịch vụ văn bản độc lập của APIMaster, không tạo tác vụ video. Tham khảo hướng dẫn công khai Volcengine; không phải API chính thức của Seedance và không phân phối Skill chính thức.

POST https://apimaster.ai/v1/video/prompt-optimize

Dùng API Key APIMaster. model chọn mô hình văn bản tính phí, cần tuyến khả dụng và quyền của Key. target_model là mô hình video; chỉ hỗ trợ seedance-2.5. Thay mô hình văn bản ví dụ nếu không khả dụng.

Bắt đầu nhanh

curl --fail-with-body -sS "https://apimaster.ai/v1/video/prompt-optimize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-3.1-flash-lite",
  "target_model": "seedance-2.5",
  "prompt": "A cat watches raindrops on a window, then turns toward the camera.",
  "language": "vi",
  "task": "generate",
  "duration": 5
}'

Tham số

JSON
model	Bắt buộc: ID mô hình văn bản trả phí dùng để tối ưu.
prompt	Bắt buộc: 1–12000 ký tự. Giữ nhãn tham chiếu và lời thoại.
target_model	Tùy chọn: mặc định và giá trị duy nhất là seedance-2.5.
language	Tùy chọn: ngôn ngữ đầu ra như vi hoặc en; bỏ qua để theo đầu vào. Tối đa 64 byte.
task	Tùy chọn: generate (mặc định), edit hoặc extend.
duration	Tùy chọn: số nguyên 4–30 hoặc -1. Chỉnh sửa cần bỏ qua hoặc dùng -1. Chỉ hỗ trợ lập kế hoạch, không đặt tham số tạo video.
references	Tùy chọn: tối đa 50 mô tả có label duy nhất (1–64 ký tự) và description (1–2000 ký tự). Không tải hay phân tích media.

Phản hồi

JSON Chat Completions chuẩn: kết quả tại choices[0].message.content, mức dùng tại usage. Không trả ID tác vụ video. Nếu finish_reason khác stop, đặc biệt là length, hãy kiểm tra tính đầy đủ.

{
  "object": "chat.completion",
  "model": "gemini-3.1-flash-lite",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A cat sits beside a rain-covered window, watching the drops slide down the glass. It slowly turns its head toward the camera."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 600,
    "completion_tokens": 50,
    "total_tokens": 650
  }
}

Mô tả tham chiếu

{
  "model": "gemini-3.1-flash-lite",
  "prompt": "Use @Image1 for the person and @Video1 for the camera movement.",
  "language": "vi",
  "references": [
    {
      "label": "@Image1",
      "description": "Person appearance only; ignore the background."
    },
    {
      "label": "@Video1",
      "description": "Slow camera push-in only; ignore the people."
    }
  ]
}

Lỗi và thanh toán

400 JSON, kiểu, trường hoặc giá trị sai; 401 Key sai; 403 thiếu quyền; 413 vượt 64 KiB; 415 không phải JSON; 429 giới hạn yêu cầu. Lỗi nhà cung cấp giữ định dạng và trạng thái dịch vụ văn bản.

Áp dụng giá token và nhóm, kiểm tra số dư, nhật ký và quyết toán lỗi của mô hình văn bản. Chỉ dẫn hệ thống và mô tả tính vào token đầu vào. Không thu phí video ở đây; tạo video sau đó tính phí riêng.

Tạo video sau khi kiểm tra

Gửi kết quả đầy đủ làm prompt tạo video. Gửi media, thời lượng và tỷ lệ riêng. Nhãn phải khớp thứ tự và vai trò media. Không xem media nên không đảm bảo nhất quán nhân vật, phụ đề chính xác hoặc thời gian từng khung hình.

Seedance 2.5

Giới hạn

Chỉ văn bản không streaming. Trường cấp cao không xác định, gồm stream, messages, webhook và URL media, bị từ chối. Không nhập khóa bí mật.