APIドキュメント
Seedance APIリファレンス
Seedance Video AIをアプリケーションに統合するための完全なAPIドキュメント。テキストプロンプトと画像から高品質な動画を生成します。
REST API
JSONレスポンス
動画生成
認証
Seedance APIはBearer Token認証を使用します。AuthorizationヘッダーにAPIトークンを含めてください：
Authorization: Bearer your-api-token-here
セキュリティ注意： クライアントサイドのコードや公開リポジトリにAPIトークンを絶対に公開しないでください。
ベースURL
すべてのAPIリクエストは以下に送信してください：
https://seedanceapi.org/v1
APIエンドポイント
POST
動画生成
/generateAIモデルを使用してテキストプロンプトと画像から高品質な動画を生成します。
リクエストボディ
テキストから動画 (T2V)
{
"prompt": "cardi b bends over to pick up coins",
"mode": "text",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1
}画像から動画 (I2V)
{
"prompt": "kissing",
"mode": "img2img",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1,
"image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}パラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
| prompt | 文字列 | 生成する動画のテキスト説明 |
| mode | 文字列 | 生成モード：T2Vの場合は"text"、I2Vの場合は"img2img" |
| image_url | 文字列? | 入力画像URL（img2imgモードでは必須） |
| resolution | 文字列 | 動画解像度："480p"、"720p"、または"1080p" |
| ratio | 文字列 | 動画アスペクト比（デフォルト："adaptive"） |
| duration | 整数 | 動画の長さ（秒、デフォルト：5） |
| framespersecond | 整数 | フレームレート（デフォルト：24） |
| seed | 整数 | 再現可能な結果のためのランダムシード（デフォルト：-1） |
レスポンス
{
"code": 200,
"message": "success",
"data": {
"task_id": "task_123456789"
}
}endpoints.generate.curl
テキストから動画 (T2V):
curl -X POST https://seedanceapi.org/v1/generate \
-H "Authorization: Bearer your-api-token" \
-H "Content-Type: application/json" \
-d '{
"prompt": "cardi b bends over to pick up coins",
"mode": "text",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1
}'画像から動画 (I2V):
curl -X POST https://seedanceapi.org/v1/generate \
-H "Authorization: Bearer your-api-token" \
-H "Content-Type: application/json" \
-d '{
"prompt": "kissing",
"mode": "img2img",
"resolution": "480p",
"ratio": "adaptive",
"duration": 5,
"framespersecond": 24,
"seed": -1,
"image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}'GET
タスクステータス取得
/status?task_id=xxxx進行中または完了した動画生成タスクのステータスを確認します。
パラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
| task_id | 文字列 | 生成エンドポイントから返されたタスクID |
レスポンス
{
"code": 200,
"message": "success",
"data": {
"consumed_credits": 10,
"created_at": "2024-01-01T00:00:00Z",
"status": "completed",
"task_id": "task_123456789",
"user_request": {
"prompt": "A beautiful landscape with flowing water",
"model": "seedance-video-v1",
"duration": 5
},
"user_response": {
"video_url": "https://cdn.seedance.com/generated/video.mp4",
"last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
},
"provider_status": "success",
"model": "seedance-video-v1"
}
}endpoints.generate.curl
curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
-H "Authorization: Bearer your-api-token"エラーハンドリング
Seedance APIは標準のHTTPステータスコードとエラーメッセージを返します：
HTTPステータスコード
200OK
400Bad Request
401Unauthorized
429Rate Limited
500Server Error
エラーレスポンス形式
{
"code": 400,
"message": "Invalid request: The prompt parameter is required",
"error": "INVALID_REQUEST"
}ベストプラクティス： 常にエラーを適切に処理し、レスポンスボディを処理する前にHTTPステータスコードを確認してください。
レート制限
100
リクエスト/分
無料プラン
1000
リクエスト/分
Proプラン
5000
リクエスト/分
エンタープライズ
レート制限ヘッダー： 各レスポンスには現在の使用状況を追跡するためのX-RateLimit-RemainingとX-RateLimit-Resetヘッダーが含まれます。