Sora 2 + 安定版 + プロ
品質とコストのニーズに合ったモデル文字列 (sora-2、sora-2-stable、または sora-2-pro) を選択してください。
プロバイダー中立のリクエスト
type VideoGenerationRequest = {
prompt: string;
imageUrl?: string;
aspectRatio: "16:9" | "9:16";
durationSeconds: number;
quality: "standard" | "high";
callbackUrl?: string;
};
type VideoGenerationResult = {
id: string;
status: "queued" | "running" | "succeeded" | "failed";
progress: number;
outputUrl?: string;
errorCode?: string;
};
interface VideoProvider {
create(input: VideoGenerationRequest): Promise<{ id: string }>;
retrieve(id: string): Promise<VideoGenerationResult>;
}製品をモデルから分離する
プロバイダー固有コードの前に入力、状態、エラー、URLを正規化します。
透明性のある請求
各呼び出しには、10 秒の sora-2/sora-2-stable の場合は 100 クレジット、15 秒の sora-2/sora-2-stable の場合は 150 クレジット、または sora-2-pro の場合は 150 クレジットがかかり、世代が失敗した場合は自動的に返金されます。
予測可能なポーリング
タスクを作成し、チェック結果エンドポイントをポーリングして、SSE を使用せずにステータスと進行状況の同期を維持します。
推奨される統合フロー
移行期限
OpenAIは2026年9月24日にSora 2とVideos APIを終了予定です。代替を事前検証してください。
タスクを作成する
プロンプトとともに 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が返されます。
次のモデル変更を日常的な作業に
アプリのエンドポイントを固定し、選択処理を交換可能なアダプターに置きます。