API Hop

ドキュメント

API Hop ドキュメント

Seedance 2.0 の動画生成

Seedance 2.0 のテキスト、開始・終了フレーム、マルチモーダル、音声生成のパラメータ。

POSThttps://api.apihop.ai/v1/video/seedance

Seedance 2.0 の非同期ジョブを作成します。Seedance 2.5 については、専用のパラメータリファレンスを使用してください。

認証

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

リクエストボディ

modelstring必須

seedance-2.0 またはその別名 seedance-2-0 を指定します。

promptstring

動画のプロンプトです。テキストのみの生成では必須ですが、画像または動画の参照を指定する場合は省略または空欄にできます。音声だけでは有効な入力になりません。 metadata.content 内のテキスト項目は破棄され、この最上位のプロンプトのみが使用されます。

secondsstring既定値: 5

"4" から "15" までの整数を表す文字列です。数値の別名 duration も使用できます。両方を指定する場合は、同じ値にする必要があります。自動の長さ（-1）には対応していません。

sizestring既定値: 720p

出力解像度です。480p、720p、1080p、4k を指定できます。アスペクト比ではありません。 解像度の優先順位は、metadata.resolution、size、resolution の順です。

aspectRatiostring既定値: 16:9

16:9、9:16、1:1、4:3、3:4、21:9、adaptive のいずれかです。 aspect_ratio と ratio は別名です。metadata.ratio が優先されます。 各設定には別名を 1 つだけ使用してください。

metadataobject

resolution、ratio、content、generate_audio を受け付けます。 生成音声を制御するには、generate_audio に真偽値を設定してください。 最上位の generateAudio / generate_audio は別名です。音声の制御は 1 つだけ指定してください。

imagesstring[]

画像の省略記法です。1 枚目の画像を開始フレーム、2 枚目を終了フレームとして使用します。役割を明確に指定するには metadata.content を使用してください。既存の別名 imageUrls、imageUrl、image_urls、image_url も、同じフレームの意味で引き続き受け付けます。

imageWithRolesobject[]

url と role を持つ画像です。役割は first_frame、last_frame、reference_image のいずれかです。 image_with_roles は別名です。どちらのバージョンも、型を指定した metadata.content を受け付けます。

videoUrlsstring[]

参照動画です。videoUrl、video_urls、video_url は別名です。

audioUrlsstring[]

参照音声です。audioUrl、audio_urls、audio_url は別名です。 同じリクエスト内に画像または動画の参照が必要です。

callback_urlstring

任意のネイティブコールバック URL です。利用可否は選択したチャネルによって異なります。結果の正式な判断基準には GET https://api.apihop.ai/v1/jobs/{jobId} を使用してください。

マルチモーダルコンテンツ

metadata.content の各メディア項目には、対応する入れ子の URL オブジェクトが含まれます。 メディア URL には、公開 HTTP(S) URL または既存の asset:// 識別子を使用できます。

種類URL フィールド役割
image_urlimage_url.urlfirst_frame、last_frame、reference_image
video_urlvideo_url.urlreference_video
audio_urlaudio_url.urlreference_audio

省略記法と型付きコンテンツを合わせて、画像は最大 9 枚、動画は最大 3 本、音声は最大 3 ファイルまで受け付けます。音声には画像または動画が必要です。draft_task には対応していません。 type: "text" のコンテンツ項目ではなく、最上位の prompt を使用してください。 最上位の first_frame_url、last_frame_url、reference_image_urls、reference_video_urls、reference_audio_urls は、役割別の省略記法です。 コンテンツ項目内の、一覧にないフィールドは転送されません。

negativePrompt、seed、returnLastFrame、nsfwCheck、tools、webhook、watermark、outputFormat およびそれらのスネークケースの別名など、未対応の制御は拒否されます。 width、height、fps、cfgScale、steps、style には対応していません。

リクエスト例

テキストから動画を生成

json
{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}

開始フレームと終了フレーム

json
{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}

画像と音声の参照

json
{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}

送信と結果

レスポンスの data には jobId、status、model、message が含まれます。 送信の成功は、ジョブが受け付けられたことを意味し、完了を意味するものではありません。同じアカウントの API キーで GET https://api.apihop.ai/v1/jobs/{jobId} をポーリングしてください。 非同期ジョブの取得を参照してください。

状態が COMPLETED になったら data.outputResult を読み取ってください。 各結果オブジェクトの url は、文字列と URL の配列の両方を扱えるようにしてください。 課金は実際の完了トークン数と出力解像度によって決まります。動画の参照がある場合は動画入力の料金が適用されますが、画像・音声のみの参照では適用されません。