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 を返します。

パラメータタイプ必須説明
promptstring (max 1000 chars)はいメインシーンの説明(テキストまたは画像フロー)。
aspect_ratiostringはいサポートされているアスペクト比:16:9、9:16、1:1。image_urls が存在する場合は無視されます。
durationstringはいレンダリングの長さ(秒単位)(「5」または「10」)。
soundbooleanいいえクリップに音声を含める(同期された会話、効果音、音楽)。
image_urlsstring[]いいえオプションの参照画像 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_idstringはい/generate から返された ID。クエリ(?task_id=)または JSON ボディ経由で送信します。
フィールド説明
task_id/generate から返された ID。
statusSUCCESS (成功)
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 - 一時的な問題です。指数関数的バックオフで再試行してください。