Tikdek Video API

API 経由で Sora 2 Pro を統合

/api/v1/video/sora-pro を使用してテキスト、画像、またはストーリーボードのビデオ タスクを作成し、ステータスをポーリングし、check-result で結果を提供します。

Sora 2 Pro の納品に必要なものすべて

1 つの API は、明確な請求と予測可能なポーリングにより、Sora 2、Sora 2 Pro、およびストーリーボードのワークフローをカバーします。

サポートされる 7 つのモデル

Sora 2 のテキスト/画像、Sora 2 Stable のテキスト/画像、Sora 2 Pro のテキスト/画像/ストーリーボードのバリアントから選択します。

段階的クレジット

クレジットは、Sora 2 Pro の標準/高など、期間と品質に応じて増減します。

タスクベースの配信

タスクを作成し、チェック結果をポーリングし、最終的な result_url を送信します。

認証とベース URL

すべてのエンドポイントは https://sora2-api.com から提供されます。コンソールから Authorization ヘッダーで API キーを送信します。

  • すべてのリクエストに Authorization: Bearer YOUR_API_KEY を含めます。
  • JSON ペイロードには Content-Type: application/json を使用します。
  • 応答にはコード/メッセージ/データが含まれます。 check-result は 4xx/5xx を返す可能性があるため、HTTP ステータスも検証します。

クレジットと請求

料金はモデル、期間、品質レベルによって異なります。

  • Sora 2 テキスト/画像: 10 秒 = 100 クレジット、15 秒 = 150 クレジット。
  • Sora 2 安定したテキスト/画像: 10 秒 = 100 クレジット、15 秒 = 150 クレジット。
  • Sora 2 Pro のテキスト/画像: 10 秒 = 375、15 秒 = 675。
  • Sora 2 Pro のストーリーボード: 10 秒 = 375、15 秒 = 675、25 秒 = 875。
  • 上記の価格は最終的なものです。料金は切り上げとなります。

コアエンドポイント

まず生成タスクを作成し、クレジット残高をポーリングまたは確認します。

Sora 2 Pro ビデオを作成する

テキスト、画像、またはストーリーボードのジョブを送信し、クレジットをすぐに差し引いて、taskId を受け取ります。

方法: POSTパス: /api/v1/video/sora-pro

ペイロードパラメータ

  • モデル: 必須。上記のサポートされているモデル文字列のいずれかを使用してください。
  • プロンプト: ストーリーボードを除いて必須。生成したいシーンを記述します。
  • imageData: 画像からビデオへの変換に必要です。プレフィックス「data:image/*;base64,」が付いた Base64 データ URL。
  • imageUrl: オプション。 Base64 を送信したくない場合は、パブリック イメージ URL。
  • アスペクト比: オプション。 「ランドスケープ」または「ポートレート」(デフォルトのランドスケープ)。
  • nFrames: オプション。 「10」/「15」/「25」(25は絵コンテのみ)。
  • サイズ: オプション (プロテキスト/画像)。 「標準」または「高」。
  • ウォーターマークの削除: オプション (テキスト/画像)。ウォーターマーク フラグを削除します。デフォルトは true。
  • ショット: ストーリーボードに必要です。シーンと長さを含むショットの配列。
  • isPublic: オプション。結果がパブリックかどうか、デフォルトは true。

注意事項

  • サポートされているモデル: sora-2-text-to-video、sora-2-image-to-video、sora-2-text-to-video-stable、sora-2-image-to-video-stable、sora-2-pro-text-to-video、sora-2-pro-image-to-video、sora-2-pro-storyboard。
  • クレジットは送信時に差し引かれます。失敗したジョブは自動的に返金されます。
  • ストーリーボード モードにはショット配列が必要です。

ショットの構造

ストーリーボードのリクエストに必要です。各項目はシーンと継続時間を定義します。

[
  { "scene": "日の出、暖かい光の居心地の良いカフェ。", "duration": 7.5 }
]
  • シーン: ショットの説明。
  • 期間: 秒 (7.5 などの小数をサポート)。

サンプルリクエスト

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "夕暮れ時にネオンが輝くストリートマーケットを撮影した映画のような追跡映像。",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

応答例

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

生成結果の確認

ポーリングタスクのステータスと同期結果。

方法: POSTパス: /api/video-generations/check-result

ペイロードパラメータ

  • taskId: 必須。生成タスクの作成時に返された識別子。

注意事項

  • ステータス、進行状況、および利用可能な場合は result_url を返します。
  • 検証、許可、または見つからない場合には 4xx/5xx を返す場合があります。

サンプルリクエスト

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

応答例

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

ユーザークレジットを取得する

残りのクレジットと VIP ステータスを取得します。

方法: POSTパス: /api/get-user-credits

注意事項

  • 有効な API キーまたはセッションが必要です。
  • left_credits フィールドと is_vip フィールドを返します。

サンプルリクエスト

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

応答例

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}

1. タスクを作成する

/api/v1/video/sora-pro をペイロードとともに送信し、taskId を保存します。

2. 進捗状況を追跡する

ステータスが成功または失敗になるまで /api/video-generations/check-result をポーリングします。

3.動画を配信する

result_url/result_urls を使用して、生成されたビデオを配布または保存します。

よくある質問

どのモデルがサポートされていますか?

sora-2-text-to-video または sora-2-image-to-video を使用します。 Sora 2 Pro では、テキスト、画像、ストーリーボードのバリアントが追加されます。

nFrames はどのような値をサポートしていますか?

すべてのモードには「10」または「15」を使用します。 「25」は絵コンテのみ。 Pro のテキスト/画像は標準または高サイズをサポートしています。

チェック結果が 4xx/5xx を返すのはなぜですか?

エンドポイントは所有権と入力を検証するため、無効または無許可のタスクはコード/メッセージとともに 4xx/5xx を返す可能性があります。

役立つリソース

Tikdek Video API で起動する

API キーを作成すると、数分で Sora 2 Pro ビデオの生成を開始できます。