Skip to content

影片專用

The 视频专用 group covers Seedance, Veo, Kling, MiniMax, Grok and other video models, all called through the same video API.

計費分兩種:按條 / 按秒

This is the one thing to check before picking a model:

  • 按條計費:一次請求一個價,與時長無關。要出長片更划算。
  • 按秒計費:單價 × 時長。短片更便宜,長片按實際用量付費。

Cards in the Model Marketplace state / clip or / second directly, and the Pricing type filter on the left lets you view just one kind.

單價低不等於總價低

一個標 ¥0.375 / 秒 的模型,拍 15 秒是 ¥5.625;另一個標 ¥4.35 / 條 的模型不論多長都是 ¥4.35。務必按你實際要的時長換算之後再比。

Calling it

Video is an async job: submit, get a task_id, then poll for the result. Use a token from the 视频专用 group.

bash
curl 'https://tian-shu.net/v1/videos' \
  -H 'Authorization: Bearer <your 视频专用 group key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "neon street on a rainy night, slow dolly in, cinematic",
    "aspect_ratio": "16:9"
  }'

Then poll GET /v1/videos/{task_id}; fetch the result once status becomes completed.

取片

status 變為 completed 後,從回應的 metadata.url 下載成片。該位址固定為:

bash
curl -L 'https://tian-shu.net/v1/videos/{task_id}/content' \
  -H 'Authorization: Bearer 你的 視頻專用 分組令牌' \
  -o video.mp4

回傳 video/mp4

成片保留期有限

請在生成完成後盡快下載並自行保存。超過保留期後該位址將不再可用。

失敗時回應不含 metadata,只回傳 error.message且不計費

Parameters differ per model

Supported durations, resolutions and reference-image / first-last-frame capabilities vary a lot between models. Click the Docs button on a model card to see that model's own endpoint reference, parameter table and copy-ready samples — see Using the Marketplace.