Seedance 1.5 Pro 非同期ビデオ生成
API ドキュメンテーション
これらのエンドポイントを使用して、Seedance 1.5 Pro ジョブを送信し、ステータスを確認します。各呼び出しでは、持続時間と音声(同期された会話、効果音、音楽)に基づいてクレジットが消費されます。
認証
すべてのリクエストには、API キーを Authorization header:
Authorization: Bearer <YOUR_API_KEY>キーがないか無効な場合は、 401 Unauthorized.
POST
https://seedance1-5pro.com/api/generate
生成タスクの作成
新しい Seedance 1.5 Pro ジョブを送信します。この呼び出しは、レンダリングが非同期で完了する間、すぐに task_id を返します。
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| prompt | string (max 1000 chars) | はい | メインシーンの説明(テキストまたは画像フロー)。 |
| aspect_ratio | string | はい | サポートされているアスペクト比:16:9、9:16、1:1。image_urls が存在する場合は無視されます。 |
| duration | string | はい | レンダリングの長さ(秒単位)(「5」または「10」)。 |
| sound | boolean | いいえ | クリップに音声を含める(同期された会話、効果音、音楽)。 |
| image_urls | string[] | いいえ | オプションの参照画像 URL(画像からビデオへの変換には必須)。 |
クレジット消費
クレジットはタスク作成時に差し引かれます。失敗したジョブは自動的に返金されます。
| プリセット | 差し引かれたクレジット |
|---|---|
| 5 秒(音声なし) | 65 |
| 10 秒(音声なし) | 130 |
| 5 秒(音声あり) | 130 |
| 10 秒(音声あり) | 260 |
リクエスト例
{
"prompt": "Drone shot over neon night market",
"aspect_ratio": "16:9",
"duration": "5",
"sound": false,
"image_urls": [
"https://cdn.example.com/reference/frame01.png"
]
}レスポンス例
{
"code": 200,
"message": "success",
"data": {
"task_id": "sd15p_b6d54c8f4b4c4e8"
}
}GET / POST
https://seedance1-5pro.com/api/status
タスクステータスの確認
このエンドポイントを使用して、最新のレコードをポーリングします。タスクがまだ IN_PROGRESS (進行中) の場合は、応答する前にもう一度プロバイダーに問い合わせます。
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| task_id | string | はい | /generate から返された ID。クエリ(?task_id=)または JSON ボディ経由で送信します。 |
| フィールド | 説明 |
|---|---|
| task_id | /generate から返された ID。 |
| status | SUCCESS (成功) |
| request | 送信されたペイロードのサニタイズされたコピー。 |
| response | ステータスが SUCCESS の場合のメディア URL の配列。 |
| consumed_credits | タスクに対して請求されたクレジット(返金時は 0)。 |
| error_message | ステータスが FAILED の場合のプロバイダーエラーメッセージ。 |
| created_at | ジョブが保存されたときの UTC タイムスタンプ。 |
リクエスト例
GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>
# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
{
"task_id": "sd15p_b6d54c8f4b4c4e8"
}レスポンス例
{
"code": 200,
"message": "success",
"data": {
"task_id": "sd15p_b6d54c8f4b4c4e8",
"status": "SUCCESS",
"request": {
"prompt": "Drone shot over neon night market",
"aspect_ratio": "16:9",
"duration": "5",
"sound": false
},
"response": [
"https://static.gogloai.com/seedance15pro/clip_001.mp4"
],
"consumed_credits": 65,
"error_message": null,
"created_at": "2025-06-14T05:21:11Z"
}
}エラー処理
401 Unauthorized- API キーがないか無効です。402 Payment Required- クレジット残高が控除額をカバーできませんでした。429 Too Many Requests- ポーリング頻度またはリクエストレートを下げてください。500- 一時的な問題です。指数関数的バックオフで再試行してください。