画像から動画

1枚のフレームを動くシーンへ

参照画像と動きの指示を送ると、追跡可能な動画生成タスクが返ります。

1枚のフレームを動くシーンへ

強い最初のフレームを用意する

明確な被写体、構図、動きに絞った指示が安定性を高めます。

Sora 2 + 安定版 + プロ

品質とコストのニーズに合ったモデル文字列 (sora-2、sora-2-stable、または sora-2-pro) を選択してください。

予測可能なポーリング

タスクを作成し、チェック結果エンドポイントをポーリングして、SSE を使用せずにステータスと進行状況の同期を維持します。

20 の同時リクエスト

最大 20 個のビデオ生成タスクを同時に処理します。より高い制限についてはお問い合わせください。

画像から動画タスクを作成

テキストからビデオへのプロンプト、またはオプションの画像からビデオへのプロンプトを使用して、Sora 2 または Sora Pro の生成ジョブを開始します。

画像から動画タスクを作成
curl -X POST https://sora2-api.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "prompt": "The cyclist moves forward as rain falls naturally",
    "url": "https://example.com/city-frame.jpg",
    "aspectRatio": "16:9",
    "webHook": "-1",
    "isPublic": false
  }'

推奨される統合フロー

参照画像の要件

到達可能なHTTPS URLまたはbase64を使い、出力と縦横比を合わせます。

タスクを作成する

プロンプトとともに Tikdek リクエストを送信し、返された taskId を保存します。

進捗状況を追跡する

ステータスが成功または失敗になるまで、結果確認エンドポイントを呼び出します。

動画を配信する

result_url/result_urls のストレージを利用した URL を使用して、生成されたビデオを提供またはダウンロードします。

よくある質問

リクエストを認証するにはどうすればよいですか?

コンソールで API キーを作成し、それを Authorization: Bearer YOUR_API_KEY として含めます。キーはいつでもローテーションできます。

結果を得るためにどのようにポーリングすればよいですか?

create を呼び出した後、taskId を保存します。ステータスが成功または失敗するまで 3 ~ 5 秒ごとに /api/video-generations/check-result を呼び出し、その後 result_url/result_urls を使用します。

失敗した場合のクレジットはどのように処理されますか?

タスクが失敗した場合はクレジットが自動的に返金され、監査証跡のチェック結果ペイロードでrefund_trans_noとcredits_refunded=trueが返されます。

最初の画像を動かす

具体的な動きから始め、返されたタスクIDを完了まで追跡します。