動画(非同期ジョブ)

Veo 3.1、Sora 2 Pro、Kling、Seedance、Runway、Wan、Hailuo などで動画を生成します。動画の生成には数十秒から数分かかるため、非同期ジョブとして実行されます。ジョブを作成し、ステータスをポーリングして、結果をダウンロードします。

ジョブを作成する

POST https://api14.com/api/v1/videos

モデルごとに対応する長さ、解像度、アスペクト比は、GET /videos/models(公開)またはモデルのページで確認できます。

残高チェック

ジョブを送信する前に、ゲートウェイは長さ × 指定した解像度(および音声オプション)の 1 秒あたりの価格で料金を見積もります。残高が見積もりを下回っている場合、リクエストは 402 insufficient_balance で失敗し、何も開始されません。

レスポンス

{
  "id": "vid_01JABCDEF",
  "status": "queued",
  "polling_url": "/api/v1/videos/vid_01JABCDEF"
}

ジョブをポーリングする

GET https://api14.com/api/v1/videos/{id}

{
  "id": "vid_01JABCDEF",
  "status": "completed",
  "generation_id": "gen-1791100000-abc",
  "unsigned_urls": ["/api/v1/videos/vid_01JABCDEF/content?index=0"],
  "usage": { "cost": 1.2 }
}

5〜10 秒ごとにポーリングしてください。ジョブを読み取れるのは作成したアカウントのみで、それ以外の ID は 404 not_found を返します。

結果をダウンロードする

GET https://api14.com/api/v1/videos/{id}/content?index=0

API キーを使って、動画のバイト(通常は video/mp4)を返します。出力 URL は常にゲートウェイを指し、上流のプロバイダーを指すことはありません。ファイルの準備ができていない、または期限切れの場合は content_unavailable が返ります。

例

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

// Video generation is asynchronous: submit, then poll until completed.
let job = await client.post("/videos", { body: {
  "model": "google/veo-3.1-fast",
  "prompt": "A drone shot over turquoise ocean waves at sunrise",
  "duration": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9"
} });
while (!["completed", "failed"].includes(job.status)) {
  await new Promise((r) => setTimeout(r, 5000));
  job = await client.get(`/videos/${job.id}`);
}
console.log(job.status, job.unsigned_urls);

課金

ジョブが completed に達した時点で、プロバイダーの実際のコストで1 回だけ課金されます。失敗、キャンセル、期限切れのジョブは無料です。ジョブはバックグラウンドでも完了するため、ポーリングしなかったジョブも精算され、Usage に表示されます。

エラー

エラーを参照してください。