動画生成タスク

API 概要

動画生成は非同期処理です：

1. 呼び出し POST /v1/videos/tasks タスクの送信
2. レスポンス内の公開タスク ID を保存
3. 呼び出し GET /v1/tasks/{task_id} ステータスと結果の照会

Base URL は https://api.rokoapi.com/v1。すべてのリクエストには Authorization: Bearer $API_KEY。

対応モデル

実際の利用可能範囲は /v1/models、コンソールのチャネル設定、および API キーが属するグループを基準とします。ユーザーは製品モデルを選択するだけで、RokoAPI は generation_type と素材フィールドに基づき、EvoLink のテキストから動画、画像から動画、リファレンスから動画、または編集ルーティングを自動的に選択します。

テキストから動画

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "generation_type": "text",
    "prompt": "A cinematic sunrise over snow mountains",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

画像から動画とリファレンスから動画

通常は image_urls、video_urls と audio_urls を通じて、パブリックネットワークから直接ダウンロード可能な素材を渡します：

{
  "model": "seedance-2.0",
  "generation_type": "reference",
  "prompt": "Keep the character identity and create a slow camera orbit",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "duration": 6,
  "quality": "720p",
  "aspect_ratio": "16:9"
}

例外：Wan 2.7 の画像から動画は image_start とオプションの image_endを使用します。Grok 1.5 は image_urls の数に基づいてモードを自動的に選択します（0 枚はテキストから動画、1 枚は画像から動画、2～7 枚はリファレンスから動画）。 aspect_ratio。

動画編集

{
  "model": "wan-2.7",
  "generation_type": "edit",
  "prompt": "Change the background to a rainy neon street",
  "video_urls": ["https://example.com/input.mp4"],
  "image_urls": ["https://example.com/style.png"],
  "duration": 0,
  "quality": "720p"
}

Wan 2.7 の編集における duration: 0 は入力動画に追従することを示します。Gemini Omni の編集は入力動画に追従するため、 duration または aspect_ratio。

パラメータの境界

リクエスト内の追加モデルパラメータは、元の JSON 構造のまま EvoLink に透過的に転送されます。これには negative_prompt、generate_audio、content_filter、sound、prompt_extend および model_params。RokoAPI は、まず長さ、画質、アスペクト比、素材の数、コールバック URL などの既知の境界値を検証します。動画 API では n はサポートされていません。 n。

コールバックとクエリ

任意の callback_url は公開 HTTPS である必要があります。最大 2048 文字で、localhost やプライベート IP を指してはいけません。コールバックを設定した場合でも、フォールバックとしてポーリングを維持することを推奨します：

curl https://api.rokoapi.com/v1/tasks/task_public_id \
  -H "Authorization: Bearer $API_KEY"

一般的なステータスには queued、in_progress、completed および failed。結果リンクには有効期限がある場合があります。本番環境では、速やかにダウンロードして保存してください。

課金について

モデルは、統一された v2 米ドル式課金を採用しています。出力秒数、入力参照動画の秒数、入力画像の数、音声の有無、解像度、画質、生成方法、およびトークン使用量を 1 つの式で組み合わせることができます。送信時に検証済みのパラメータに基づいて事前課金を行い、タスク完了後に実際のトークン数または出力時間に基づいて精算します。

以下は 2026-08-20 時点の固定価格スナップショットです。EvoLink が公開したコスト価格の 10% のサービス料が含まれており、単位はすべて米ドルです。価格は上流のクレジットに連動してリアルタイムで変化しません。管理者が上流の価格改定を承認した後、この表とバックエンドの式を更新します。

Seedance 2.0 シリーズ

Fast と Mini のキャンペーン価格は EvoLink の 2026-08-07 の価格改定に基づいています。キャンペーン終了後、RokoAPI の価格は自動的に変更されず、その時点ではバックエンドで承認された新しいスナップショットが基準となります。

その他の秒単位課金の動画モデル

Kling O3 は、解像度と音声の有無の両方に基づいて課金されます：

Sora 2 シリーズ

Gemini Omni トークン価格

参考動画の長さは、システムがメディアメタデータの検証を完了し、または信頼できる使用量を取得した後にのみ最終請求に反映されます。正確な価格は料金ページおよびバックエンドの現在の設定に基づきます。上流の価格情報は EvoLink モデルカタログおよび各モデルの開発ページをご参照ください。