OpenAI ビデオフォーマット（Soraフォーマット）¶

OpenAIビデオ生成インターフェースを呼び出してビデオを生成します。Soraなどのモデルをサポートし、OpenAIビデオフォーマットを使用してKling（可霊）、Jimeng（即夢）、Viduを呼び出すこともサポートしています。

ビデオ生成¶

APIエンドポイント¶

POST /v1/videos

リクエストヘッダー¶

パラメータ	タイプ	必須	説明
Authorization	string	はい	ユーザー認証トークン (Bearer: sk-xxxx)

リクエストパラメータ (multipart/form-data)¶

パラメータ	タイプ	必須	説明
prompt	string	はい	生成したいビデオを記述するテキストプロンプト
model	string	いいえ	ビデオ生成モデル。デフォルトは sora-2
seconds	string	いいえ	ビデオの長さ（秒）。デフォルトは 4 秒
size	string	いいえ	出力解像度。幅x高さの形式。デフォルトは 720x1280
input_reference	file	いいえ	入力画像ファイル（画像からビデオ生成時に使用）
metadata	string	いいえ	拡張パラメータ（JSON文字列形式）

metadata パラメータの説明¶

metadata パラメータの役割は、Soraモデル固有ではないパラメータ（例：阿里云万相の画像URL、透かし、プロンプトのスマートリライトなど）を渡すことです。metadata パラメータの形式は JSON 文字列です。例：

{
  "img_url": "https://example.com/image.jpg",
  "watermark": false,
  "prompt_extend": true
}

リクエスト例¶

テキストからビデオ生成 (T2V) (テキストプロンプトのみ)¶

curl https://你的newapi服务器地址/v1/videos \
  -H "Authorization: Bearer sk-xxxx" \
  -F "prompt=一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级" \
  -F "model=sora-2" \
  -F "seconds=5" \
  -F "size=1920x1080"

画像からビデオ生成 (I2V) (テキストプロンプト + 画像ファイル)¶

curl https://你的newapi服务器地址/v1/videos \
  -H "Authorization: Bearer sk-xxxx" \
  -F "prompt=猫咪慢慢睁开眼睛，伸懒腰" \
  -F "model=sora-2" \
  -F "seconds=3" \
  -F "size=1920x1080" \
  -F "input_reference=@/path/to/cat.jpg"

阿里云万相ビデオ生成例¶

テキストからビデオ生成 (Wanxiang 2.5)¶

curl https://你的newapi服务器地址/v1/videos \
  -H "Authorization: Bearer sk-xxxx" \
  -F "prompt=一只可爱的小猫在花园里玩耍，阳光明媚，色彩鲜艳" \
  -F "model=wan2.5-t2v-preview" \
  -F "seconds=5" \
  -F "size=1920*1080"

画像からビデオ生成 (Wanxiang 2.5)¶

curl https://你的newapi服务器地址/v1/videos \
  -H "Authorization: Bearer sk-xxxx" \
  -F "prompt=让这张图片动起来，添加自然的运动效果" \
  -F "model=wan2.5-i2v-preview" \
  -F "seconds=5" \
  -F "size=1280P" \
  -F 'metadata={"img_url":"https://example.com/image.jpg"}'

レスポンス形式¶

201 - 作成成功¶

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

レスポンスフィールドの説明¶

フィールド	タイプ	説明
id	string	ビデオタスクID
object	string	オブジェクトタイプ。固定で "video"
model	string	使用されたモデル名
created_at	integer	作成タイムスタンプ
status	string	タスクステータス（processing: 処理中）
progress	integer	生成進捗率（パーセンテージ）

ビデオの照会¶

タスクIDに基づいてビデオ生成タスクのステータスと結果を照会します。

APIエンドポイント¶

GET /v1/videos/{video_id}

パスパラメータ¶

パラメータ	タイプ	必須	説明
video_id	string	はい	ビデオタスクID

リクエスト例¶

curl 'https://你的newapi服务器地址/v1/videos/video_123' \
  -H "Authorization: Bearer sk-xxxx"

レスポンス形式¶

200 - 成功レスポンス¶

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "created_at": 1640995200,
  "status": "succeeded",
  "progress": 100,
  "expires_at": 1641081600,
  "size": "1920x1080",
  "seconds": "5",
  "quality": "standard"
}

レスポンスフィールドの説明¶

フィールド	タイプ	説明
id	string	ビデオタスクID
object	string	オブジェクトタイプ。固定で "video"
model	string	使用されたモデル名
created_at	integer	作成タイムスタンプ
status	string	タスクステータス（processing: 処理中, succeeded: 成功, failed: 失敗）
progress	integer	生成進捗率（パーセンテージ）
expires_at	integer	リソース有効期限のタイムスタンプ
size	string	ビデオ解像度
seconds	string	ビデオの長さ（秒）
quality	string	ビデオ品質
url	string	ビデオダウンロードリンク（完了時）

ビデオタスクステータスの取得¶

タスクIDに基づいてビデオ生成タスクの詳細情報を取得します。

APIエンドポイント¶

GET /v1/videos/{video_id}

パスパラメータ¶

パラメータ	タイプ	必須	説明
video_id	string	はい	取得するビデオタスク識別子

リクエスト例¶

curl 'https://你的newapi服务器地址/v1/videos/video_123' \
  -H "Authorization: Bearer sk-xxxx"

レスポンス形式¶

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "created_at": 1640995200,
  "status": "succeeded",
  "progress": 100,
  "expires_at": 1641081600,
  "size": "1920x1080",
  "seconds": "5",
  "quality": "standard",
  "remixed_from_video_id": null,
  "error": null
}

レスポンスフィールドの説明¶

フィールド	タイプ	説明
id	string	ビデオタスクの一意の識別子
object	string	オブジェクトタイプ。固定で "video"
model	string	ビデオを生成したモデル名
status	string	ビデオタスクの現在のライフサイクルステータス
progress	integer	生成タスクのおおよその完了パーセンテージ
created_at	integer	タスク作成時のUnixタイムスタンプ（秒）
expires_at	integer	ダウンロード可能なリソースの有効期限が切れるUnixタイムスタンプ（秒）。設定されている場合
size	string	生成されたビデオの解像度
seconds	string	生成されたビデオクリップの長さ（秒）
quality	string	ビデオ品質
remixed_from_video_id	string	このビデオがリミックスである場合、ソースビデオの識別子
error	object	生成に失敗した場合、エラー情報を含むオブジェクト

ビデオコンテンツの取得¶

完了したビデオコンテンツをダウンロードします。

APIエンドポイント¶

GET /v1/videos/{video_id}/content

パスパラメータ¶

パラメータ	タイプ	必須	説明
video_id	string	はい	ダウンロードするビデオの識別子

クエリパラメータ¶

パラメータ	タイプ	必須	説明
variant	string	いいえ	返されるダウンロード可能なリソースのタイプ。デフォルトはMP4ビデオ

リクエスト例¶

curl 'https://你的newapi服务器地址/v1/videos/video_123/content' \
  -H "Authorization: Bearer sk-xxxx" \
  -o "video.mp4"

レスポンスの説明¶

ビデオファイルストリームを直接返却します。Content-Typeは video/mp4 です。

レスポンスヘッダー¶

フィールド	説明
Content-Type	ビデオファイルタイプ。通常は video/mp4
Content-Length	ビデオファイルサイズ（バイト）
Content-Disposition	ファイルダウンロード情報

エラーレスポンス¶

400 - リクエストパラメータエラー¶

{
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

401 - 未承認¶

{
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

403 - 権限なし¶

{
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

404 - タスクが存在しません¶

{
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

500 - サーバー内部エラー¶

{
  "error": {
    "message": "string",
    "type": "server_error"
  }
}

サポートされているモデル¶

OpenAI互換¶

sora-2: Soraビデオ生成モデル

OpenAIフォーマット経由で呼び出されるその他のサービス¶

阿里云万相 (Ali Wan): wan2.5-t2v-preview (テキストからビデオ生成), wan2.5-i2v-preview (画像からビデオ生成), wan2.2-i2v-flash, wan2.2-i2v-plus, wanx2.1-i2v-plus, wanx2.1-i2v-turbo を使用
可霊AI (Kling): kling-v1, kling-v2-master を使用
即夢 (Jimeng): jimeng_vgfm_t2v_l20, jimeng_vgfm_i2v_l20 を使用
Vidu: viduq1 を使用

阿里云万相の特記事項¶

サポートされている機能¶

テキストからビデオ生成 (t2v): テキストプロンプトのみを使用してビデオを生成
画像からビデオ生成 (i2v): テキストプロンプト + 画像を使用してビデオを生成
最初と最後のフレームからのビデオ生成 (kf2v): 最初と最後のフレーム画像を指定してビデオを生成
音声生成 (s2v): 音声とビデオの結合をサポート

解像度のサポート¶

480P: 832×480, 480×832, 624×624
720P: 1280×720, 720×1280, 960×960, 1088×832, 832×1088
1080P: 1920×1080, 1080×1920, 1440×1440, 1632×1248, 1248×1632

特殊パラメータ¶

watermark: 透かしを追加するかどうか（デフォルトはfalse）
prompt_extend: プロンプトのスマートリライトを有効にするかどうか（デフォルトはtrue）
audio: 音声を追加するかどうか（wan2.5のみサポート）
seed: 乱数シード

モデルの特徴¶

wan2.5-i2v-preview: Wanxiang 2.5 プレビューバージョン。音声付きビデオをサポート。推奨
wan2.2-i2v-flash: Wanxiang 2.2 高速版。生成速度が速い。音声なしビデオ
wan2.2-i2v-plus: Wanxiang 2.2 プロフェッショナル版。画質が高い。音声なしビデオ
wanx2.1-i2v-plus: Wanxiang 2.1 プロフェッショナル版。安定バージョン
wanx2.1-i2v-turbo: Wanxiang 2.1 高速版

ベストプラクティス¶

リクエスト形式: multipart/form-data 形式を使用します。これはOpenAI公式が推奨する方法です。
input_referenceパラメータ: 画像からビデオ生成機能に使用されます。画像ファイルをアップロードする際は @filename 構文を使用します。
プロンプトの最適化: スタイルや品質要件を含む、詳細で具体的な記述を使用します。
パラメータ設定: 要件に応じて、長さと解像度を適切に設定します。
阿里云万相の特記事項:
ファイルの直接アップロードはサポートされていません。すべてのリソースはURL経由で渡されます。
すべての拡張パラメータは metadata パラメータ（JSON文字列形式）を使用して渡します。
画像からビデオ生成では metadata.img_url を使用して画像URLを渡します。
最初と最後のフレームからのビデオ生成では metadata.first_frame_url と metadata.last_frame_url を使用します。
エラー処理: 適切なリトライメカニズムとエラー処理を実装します。
非同期処理: ビデオ生成は非同期タスクであるため、ステータスをポーリングして照会する必要があります。
リソース管理: 不要になったビデオファイルは速やかにダウンロードし、クリーンアップします。

JavaScriptの例¶

FormDataの使用 (推奨)¶

async function generateVideoWithFormData() {
  const formData = new FormData();
  formData.append('prompt', '一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级');
  formData.append('model', 'sora-2');
  formData.append('seconds', '5');
  formData.append('size', '1920x1080');

  const response = await fetch('https://你的newapi服务器地址/v1/videos', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-xxxx'
    },
    body: formData
  });

  const result = await response.json();
  return result.id;
}

// 图生视频示例
async function generateVideoWithImage() {
  const formData = new FormData();
  formData.append('prompt', '猫咪慢慢睁开眼睛，伸懒腰');
  formData.append('model', 'sora-2');
  formData.append('seconds', '3');
  formData.append('size', '1920x1080');

  // 添加图片文件
  const imageFile = document.getElementById('imageInput').files[0];
  formData.append('input_reference', imageFile);

  const response = await fetch('https://你的newapi服务器地址/v1/videos', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-xxxx'
    },
    body: formData
  });

  const result = await response.json();
  return result.id;
}

阿里云万相呼び出し例¶

// 阿里云万相文生视频
async function generateAliVideo() {
  const formData = new FormData();
  formData.append('prompt', '一只可爱的小猫在花园里玩耍，阳光明媚，色彩鲜艳');
  formData.append('model', 'wan2.5-t2v-preview');
  formData.append('seconds', '5');
  formData.append('size', '1920*1080');
  formData.append('metadata', JSON.stringify({
    watermark: false,
    prompt_extend: true
  }));

  const response = await fetch('https://你的newapi服务器地址/v1/videos', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-xxxx'
    },
    body: formData
  });

  const result = await response.json();
  return result.id;
}

// 阿里云万相图生视频
async function generateAliImageToVideo() {
  const formData = new FormData();
  formData.append('prompt', '让这张图片动起来，添加自然的运动效果');
  formData.append('model', 'wan2.5-i2v-preview');
  formData.append('seconds', '3');
  formData.append('resolution', '720P');
  formData.append('input_reference', imageFile);
  formData.append('metadata', JSON.stringify({
    watermark: false,
    prompt_extend: true
  }));

  const response = await fetch('https://你的newapi服务器地址/v1/videos', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-xxxx'
    },
    body: formData
  });

  const result = await response.json();
  return result.id;
}

// 阿里云万相首尾帧生视频
async function generateAliKeyframeVideo() {
  const formData = new FormData();
  formData.append('prompt', '从开始到结束的平滑过渡动画');
  formData.append('model', 'wan2.2-kf2v-flash');
  formData.append('seconds', '4');
  formData.append('metadata', JSON.stringify({
    first_frame_url: 'https://example.com/start.jpg',
    last_frame_url: 'https://example.com/end.jpg',
    resolution: '720P',
    watermark: false
  }));

  const response = await fetch('https://你的newapi服务器地址/v1/videos', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-xxxx'
    },
    body: formData
  });

  const result = await response.json();
  return result.id;
}

OpenAI ビデオフォーマット（Soraフォーマット）¶

ビデオ生成¶

APIエンドポイント¶

リクエストヘッダー¶

リクエストパラメータ (multipart/form-data)¶

metadata パラメータの説明¶

リクエスト例¶

テキストからビデオ生成 (T2V) (テキストプロンプトのみ)¶

画像からビデオ生成 (I2V) (テキストプロンプト + 画像ファイル)¶

阿里云万相 ビデオ生成例¶

テキストからビデオ生成 (Wanxiang 2.5)¶

画像からビデオ生成 (Wanxiang 2.5)¶

レスポンス形式¶

201 - 作成成功¶

レスポンスフィールドの説明¶

ビデオの照会¶

APIエンドポイント¶

パスパラメータ¶

リクエスト例¶

レスポンス形式¶

200 - 成功レスポンス¶

レスポンスフィールドの説明¶

ビデオタスクステータスの取得¶

APIエンドポイント¶

パスパラメータ¶

リクエスト例¶

レスポンス形式¶

レスポンスフィールドの説明¶

ビデオコンテンツの取得¶

APIエンドポイント¶

パスパラメータ¶

クエリパラメータ¶

リクエスト例¶

レスポンスの説明¶

レスポンスヘッダー¶

エラーレスポンス¶

400 - リクエストパラメータエラー¶

401 - 未承認¶

403 - 権限なし¶

404 - タスクが存在しません¶

500 - サーバー内部エラー¶

サポートされているモデル¶

OpenAI互換¶

OpenAIフォーマット経由で呼び出されるその他のサービス¶

阿里云万相の特記事項¶

サポートされている機能¶

解像度のサポート¶

特殊パラメータ¶

モデルの特徴¶

ベストプラクティス¶

JavaScriptの例¶

FormDataの使用 (推奨)¶

阿里云万相呼び出し例¶

阿里云万相ビデオ生成例¶