画像・動画生成 API を EastX で使う｜タスク照会と重複防止
画像生成と非同期動画タスクのエンドポイント、状態確認、タイムアウト時の重複防止を解説します。
EastX で画像と動画の API を使う
画像を理解する処理、画像を生成する処理、動画を生成する処理はそれぞれ異なります。EastX の管理画面で API キーと利用状況をまとめつつ、作業に合うモデルとエンドポイントを選びます。モデル ID、対応する入力形式、解像度と現在の料金をモデル一覧で確認してください。
画像を生成する
対応する画像モデルを選び、POST /v1/images/generations を使います。プロンプト、枚数とサイズは選択したモデルの対応条件に合わせます。生成画像の URL が返った場合、必要な成果物はダウンロードして保存してください。あるモデルが対応するサイズが、すべてのモデルで使えるとは限りません。
動画タスクを作成する
動画生成には POST /v1/contents/generations/tasks を使います。以下はリクエストの構造例です。モデル ID と選択できる解像度、秒数は対象モデルの詳細を確認してください。
{
"model": "YOUR_VIDEO_MODEL_ID",
"content": [{"type": "text", "text": "湖の上を飛ぶ紙飛行機"}],
"resolution": "720p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}
作成時には安定した Idempotency-Key を送り、返されたタスク ID を保存します。GET /v1/contents/generations/tasks/{task_id} で同じタスクを照会し、queued または processing なら待ちます。succeeded の後に content.video_url を読み取り、failed は終了状態として扱います。ドキュメントは同じタスクを約 10 秒ごとに照会する方法を示しています。
タイムアウト時に重複生成を防ぐ
画面が変わらないことやネットワークのタイムアウトだけで、新しいキーを使ってタスクを作り直す必要はありません。作成を再試行する場合は、同じ Idempotency-Key と同じ本文を使います。pending_confirmation の場合は元のタスクを照会し、サポートに確認してください。billing_pending の場合は残高と元のキーの利用上限を確認します。
素材と費用を管理する
画像、動画、音声の参照は、モデルが対応する content フィールドと、アクセス可能な HTTPS URL または許可された素材参照を使います。ローカル PC のファイルパスは遠隔 API からそのまま参照できません。費用の見積もりではモデル、解像度、秒数、音声の有無を確認します。
タスクごとに入力のバージョン、ID、状態、出力先を保存すると、中断後の確認と制作コストの比較に役立ちます。