API クイックスタート / 人間 + AGENT 対応
キーを作成する前に、統合を組み上げる。
このクイックスタートでコードの準備、payload の検証、課金モデルの把握を。本番の呼び出しには、人間のユーザーが作成した provider API キーが必要です。
ステータス本番呼び出し前に確認
Expected Provider-mediated access
Seedance 2.5 API availability should be verified with the provider before production use. Build behind a configurable model parameter.
コードCURL + NODE
curl https://api.evolink.ai/v1/videos/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-reference-to-video",
"prompt": "A clean product shot, slow dolly in, soft daylight",
"duration": 5,
"quality": "720p",
"generate_audio": true
}' const resp = await fetch("https://api.evolink.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.EVOLINK_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: process.env.SEEDANCE_MODEL || "seedance-2.5-reference-to-video",
prompt,
duration: 5,
quality: "720p",
generate_audio: true,
}),
});
// Returns a job id; poll GET /v1/task-detail?id=<id> until status is completed.
const job = await resp.json(); パラメータリクエストボディ
| フィールド | 型 | 必須 | 備考 |
|---|---|---|---|
| model | string | 必須 | Seedance 2.5 モデル ID(pre-release)。設定可能にしておく。 |
| prompt | string | 必須 | 主体、動き、スタイル、制約を含むショット記述。 |
| duration | integer | 任意 | 4–30 秒、デフォルト 5。まず短い時間でテスト。 |
| quality | string | 任意 | 480p または 720p(デフォルト 720p)。1080p/4K は未定として扱う。 |
| generate_audio | boolean | 任意 | デフォルト true。ネイティブ音声、追加料金なし。 |
| content_filter | boolean | 任意 | デフォルト true(無料)。false は 1.1 倍のコストがかかる。 |
| image_urls / video_urls / audio_urls | array | 任意 | 参照素材:最大 30 / 10 / 10 個の URL。任意。 |
| callback_url | url | 任意 | 非同期完了用の HTTPS webhook。polling でも可。 |
機械可読 schema: /openapi.json / Agent ガイド: /agent.md
引き継ぎ最終ステップ
コードはキーなしで準備できる。本番呼び出しはできない。
provider キーを作成し、EVOLINK_API_KEY として設定。本番トラフィックの前に、低コストの短いテストを実行してください。