リファレンスv1.0.0 安定版

AI Video to PromptのAPI

高性能なAI画像生成機能を統合できます。本ドキュメントでは、完全なAPIリファレンス、連携ガイド、コードサンプルを提供し、開発者がすばやくAI画像アプリケーションを構築できるようにします。

https://aivideotoprompt.com
01

クイックスタート

生成タスクを送信し、ステータスをポーリングするだけの2ステップで、最初のAPI呼び出しを完了できます。

1

タスクを送信

POSTリクエストを generate エンドポイントに送信し、タスクIDを取得します。

2

ステータスを確認

タスクIDを使って進行状況を確認し、画像URLが返されるまでポーリングします。

02

認証

注意: APIキーは安全に保管し、クライアントサイドのコードに公開しないでください。

HTTPヘッダー
Authorization: Bearer {YOUR_API_KEY}
POST
https://aivideotoprompt.com/api/generate

新しい画像生成タスクを作成します。このエンドポイントは非同期で、task_idと初期状態を返します。完成した画像は/api/statusで取得してください。

このエンドポイントはすぐにtask_idを返します。状態がSUCCESSになるまで/api/statusをポーリングすると、画像のURLを取得できます。

リクエストボディのパラメータ

パラメータ名型必須説明
promptstring必須生成用のテキストプロンプト（最大1000文字）。
aspect_ratiostring必須生成画像のアスペクト比。指定できる値：1:1、4:3、3:4、16:9、9:16。
レスポンス(JSON)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://aivideotoprompt.com/api/status

タスクの実行ステータスと結果を照会します。

クエリパラメータ

パラメータ名必須説明
task_id必須タスク送信時に返されるID。
レスポンス例
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

課金

1回あたりの料金

$0.02 / リクエスト

失敗したタスクには料金は発生しません。

エラー処理

  • 401 認証が必要無効なAPIキー
  • 402 支払いが必要残高不足
  • 429 リクエスト数が上限を超過レート制限に達しました
03

AI Video to Promptについて

AI Video to Promptは、アップロードした参考動画をタイムコード付きのショット一覧と編集可能なプロンプトに変換します。選択した動画モデルに合わせてショットを調整したり、被写体を置き換えたりした後、動画ワークスペースで新しい動画を生成できます。画像ツールでも、静止画からプロンプトを作り、ワークスペースに引き継ぐ同じ流れを利用できます。

Z-Image-Turbo — 60億パラメータの超高速テキスト→画像モデル

Z-Image-Turboは、Tongyi-MAIによる60億パラメータのテキスト・トゥ・イメージモデルで、レイテンシとスループットが重要となる本番ワークロード向けに設計されています。8ステップのサンプリングだけでフル画像を描画し、データセンターGPU上でサブセカンドレイテンシを達成し、多くの16 GB VRAMコンシューマカードでも快適に動作します。

本番品質を備えた超高速生成

多くの拡散モデルが数十ステップを必要とする一方で、Z-Image-Turboは8ステップサンプラーに最適化されています。そのため、極めて高速な推論を維持しつつ、フォトリアリスティックな画像や信頼性の高いオンイメージテキストを生成でき、インタラクティブなプロダクトやダッシュボード、大規模バックエンドだけでなく、バッチ処理以外の用途にも適しています。

なぜこれほどきれいに見えるのか？

  • 高速かつフォトリアル — 数秒待つことなく、商品写真、ヒーローバナー、UIビジュアルに使える高忠実度でリアルな画像を生成します。
  • バイリンガルプロンプトとテキスト — 英語と中国語のプロンプトを理解し、画像内に多言語テキストを直接レンダリングできます。クロスマーケットのキャンペーンやポスター、スクリーンショットに便利です。
  • 低レイテンシ・少ステップ設計 — 1画像あたり8回の関数評価のみで非常に低いレイテンシを実現し、チャットボット、コンフィグツール、デザインアシスタントなど「クリック → 画像」体験に理想的です。
  • VRAMに優しいフットプリント — 16 GB VRAM環境でも良好に動作し、ローカルまたはエッジでのデプロイを現実的なものにします。
  • 大量生成にスケール — 高効率な設計により、カタログ、継続フィード画像、自動生成サムネイルなどの大規模ジョブでも、コンピュート予算を抑えつつ実行できます。
  • 再現可能な生成 — 制御可能なseedパラメータにより、以前の画像を再生成したり、ブランドセーフティや実験のために小さなバリエーションを生成したりできます。

使い方

  • promptprompt – シーン、スタイル、画像内テキスト（英語または中国語）を含む自然言語での説明。
  • sizesize（幅 / 高さ） – 出力解像度を選択します。最大1536×1536など、正方形・長方形の高解像度画像をサポートします。
  • seedseed – ランダムな結果が必要な場合は -1 を指定し、同じ出力を再現したい場合は固定の整数値を使用します。
画像生成ワークスペース画像からプロンプト

© AI Video to Prompt. 無断転載を禁じます。