API リファレンス

概要

Veo 3.1 API を使用すると、テキスト説明や画像からプログラムで AI 動画を生成できます。当社の RESTful API はシンプルで強力、アプリケーションへの統合が容易に設計されています。

ベース URL

https://veo3o1.com/api

認証

すべての API リクエストには API キーによる認証が必要です。Authorization ヘッダーに API キーを含めてください：

Authorization: Bearer YOUR_API_KEY

API キーはアカウントダッシュボードで生成できます。

動画生成

テキストまたは画像から新しい AI 動画を作成します。

エンドポイント

POST /generate-video

リクエストボディ

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

パラメータ

パラメータ	型	必須	説明
`generationType`	string	はい	生成タイプ：`text_to_video` または `image_to_video`
`prompt`	string	はい	生成したい動画の説明
`aspectRatio`	string	いいえ	動画のアスペクト比。デフォルト：`auto`
`imageUrl`	string	条件付き	`generationType` が `image_to_video` の場合は必須
`imageKey`	string	いいえ	アップロードされた画像のストレージキー

レスポンス

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

例

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

動画ステータスの取得

動画生成リクエストのステータスを確認します。

エンドポイント

GET /video-status/{uuid}

パラメータ

パラメータ	型	必須	説明
`uuid`	string	はい	生成リクエストから返された動画 UUID

レスポンス

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

ステータス値

pending：動画は処理待ちのキューに入っています
processing：動画を生成中です
completed：動画の準備が完了し、ダウンロード可能です
failed：生成に失敗しました（エラーメッセージを確認してください）

画像アップロード

画像から動画への生成用に画像をアップロードします。

エンドポイント

POST /upload-video-image

リクエスト

multipart/form-data を使用して画像ファイルをアップロードします。

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

レスポンス

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

サポートされる形式

JPEG/JPG
PNG
WebP
最大ファイルサイズ：50MB

エラーコード

コード	説明
0	成功
1000	無効なパラメータ
1001	クレジット不足
1002	認証失敗
1003	レート制限超過
5000	サーバーエラー

エラーレスポンス例

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

ベストプラクティス

適切なポーリング：動画ステータスは 5〜10 秒ごとに確認し、連続的なポーリングは避けてください
エラー処理：指数バックオフを使用したリトライロジックを実装してください
結果のキャッシュ：生成された動画を保存して再生成を避けてください
Webhooks の使用：完了通知にはポーリングより効率的です
入力の検証：API 呼び出し前にプロンプトの長さと画像形式を確認してください

サポート

API についてお困りですか？

📧 メール：aiprocessingrobot@gmail.com
💬 サポートに連絡

On this page