# Seedance 2.5 API ドキュメント

> AI Studio API で Seedance 2.5 モデルを使用して動画を生成します。

## 概要

AI Studio API を使用して Seedance 2.5 の生成タスクを作成し、タスク状態を確認します。処理は非同期です。まずタスクを作成して `taskId` を取得し、その後タスク API で結果を確認します。

## 認証

すべてのリクエストで `Authorization` ヘッダーに API Key が必要です。

```http
Authorization: Bearer YOUR_API_KEY
```

## 利用可能なモデル

| modelId | バージョン | プロバイダー | 実行モデル |
| --- | --- | --- | --- |
| `video:bytedance-seedance-2-5` | Seedance 2.5 | Bytedance Seedance 2.5 | bytedance/seedance-2-5 |

## 1. 生成タスクを作成

### エンドポイント

```http
POST https://localhost:3000/api/ai-studio/execute
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
```

### リクエスト例

```json
{
  "modelId": "video:bytedance-seedance-2-5",
  "isPublic": true,
  "payload": {
    "model": "bytedance/seedance-2-5",
    "input": {
      "prompt": "A cinematic product reveal with smooth orbit camera movement"
    }
  }
}
```

### 成功レスポンス

```json
{
  "success": true,
  "data": {
    "modelId": "video:bytedance-seedance-2-5",
    "generationId": "generation-id",
    "reservedCredits": 20,
    "taskId": "provider-task-id",
    "state": "queued"
  }
}
```

## 2. タスク状態を確認

### エンドポイント

```http
GET https://localhost:3000/api/ai-studio/tasks/{taskId}
Authorization: Bearer YOUR_API_KEY
```

### 成功レスポンス

```json
{
  "success": true,
  "data": {
    "generationId": "generation-id",
    "taskId": "provider-task-id",
    "modelId": "video:bytedance-seedance-2-5",
    "state": "succeeded",
    "mediaUrls": [
      "https://example.com/result.mp4"
    ],
    "reservedCredits": 20,
    "refundedCredits": 0
  }
}
```

## リクエストフィールド

### Seedance 2.5

#### Payload フィールド

| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"bytedance/seedance-2-5"` | bytedance/seedance-2-5 | The model name to use for generation. Required field. - Must be `bytedance/seedance-2-5` for this endpoint |
| `input` | object | はい | `-` | - | Input parameters for the generation task |

#### input フィールド

| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | いいえ | `"A serene beach at sunset with waves gently crashing on the shore, palm trees swaying in the breeze, and seagulls flying across the orange sky"` | - | The text prompt used to generate the video.. ( Max length: 30000 characters) |
| `first_frame_url` | string | いいえ | `-` | - | First frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)<br>Cannot be used simultaneously with reference_image_urls, reference_video_urls, or reference_audio_urls. |
| `last_frame_url` | string | いいえ | `-` | - | End frame image url or asset://{assetId} (for example: asset://asset-20260404242101-76djj)<br>last_frame_url cannot be passed alone; first_frame_url must be provided together with it. |
| `reference_image_urls` | string[] | いいえ | `["https://file.aiquickdraw.com/custom-page/akr/section-images/example1.png"]` | - | Enter a list of image URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj).<br>Single image requirements:<br>Format: jpeg, png, webp, bmp, tiff, gif.<br>Aspect ratio (width/height): (0.4, 2.5)<br>Width and height (px): (300, 6000)<br>Size: Single image less than 30 MB.<br>Maximum number of files: The sum of the number of frames at the beginning and end must not exceed 30.<br>Mutually exclusive with the first/last-frame scenario; |
| `reference_video_urls` | string[] | いいえ | `-` | - | Enter a list of video URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj) .<br>Single video requirements:<br>Video format: mp4, mov.<br>Resolution: 480p, 720p<br>Dimensions:<br>Aspect ratio (width/height): [0.4, 2.5]<br>Width/height (px): [300, 6000]<br>Total pixels: [640×640=409600, 834×1112=927408], i.e., the product of width and height must meet the range requirement of [409600, 927408].<br>Size: Single video not exceeding 200 MB.<br>Frame rate (FPS): [24, 60]<br>Single video duration: [2, 30] seconds; Mutually exclusive with the first/last-frame scenario; Total duration of reference videos must not exceed 30 seconds. |
| `reference_audio_urls` | string[] | いいえ | `-` | - | Enter a list of audio URLs or asset://{assetId} (for example: asset://asset-20260404242101-76djj) .<br>Single audio requirements:<br>Format: wav, mp3<br>Size: Single audio file size not exceeding 15 MB.<br>Single audio duration: [2, 30] seconds; Mutually exclusive with the first/last-frame scenario; Total duration of reference videos must not exceed 30 seconds. |
| `return_last_frame` | boolean | いいえ | `false` | - | Whether to return the last frame of the video. When draft=true, this parameter cannot be set to true. |
| `generate_audio` | boolean | いいえ | `true` | - | Whether to generate audio for the video. - **true**: Generate with audio (higher cost)<br>- **false**: Generate without audio Note: Enabling audio will increase the generation cost |
| `resolution` | enum | いいえ | `"720p"` | 480p, 720p | Video resolution - 480p for faster generation, 720p for balance. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive | Video aspect ratio configuration. |
| `duration` | number | いいえ | `5` | - | Video duration in seconds, from 4 to 30. |
| `output_format` | enum | いいえ | `"mp4"` | mp4, mov | Video output format. |
| `web_search` | boolean | いいえ | `-` | - | Enable online search? |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.<br>Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |

## 価格

生成タスクの作成時にクレジットが予約されます。作成レスポンスの `reservedCredits` が、そのリクエストで予約されたクレジット数です。

| モデル | タイプ | 仕様 | 価格 | 課金 |
| --- | --- | --- | --- | --- |
| Seedance 2.5 | 動画から動画 | 480p | 17 クレジット/秒 | （入力秒数 + 出力秒数）× 17 |
| Seedance 2.5 | テキスト/画像から動画 | 480p | 28 クレジット/秒 | 出力秒数 × 28 |
| Seedance 2.5 | 動画から動画 | 720p | 38 クレジット/秒 | （入力秒数 + 出力秒数）× 38 |
| Seedance 2.5 | テキスト/画像から動画 | 720p | 63 クレジット/秒 | 出力秒数 × 63 |

## 一般的なエラー

| ステータス | 意味 |
| --- | --- |
| `400` | Invalid request payload |
| `401` | Missing or invalid API key |
| `402` | Insufficient credits or plan limit |
| `404` | Model or task not found |
| `429` | Rate limit exceeded |
| `500` | Server error |