Sora Videos Generation API 接続説明

本文では Sora Videos Generation API の接続説明を紹介します。この API を使用すると、カスタムパラメータを入力して Sora の公式動画を生成できます。本 API は二つのバージョンモードをサポートしています：

Version 1（クラシックモード）：duration（10/15/25 秒）、orientation（横向き/縦向き）、size（small/large 解像度）、参考画像 image_urls、キャラクタービデオ character_url などのパラメータをサポートします。
Version 2（パートナーモード）：seconds（4/8/12 秒）、ピクセル単位の解像度 size（例：1280x720）、参考画像 input_reference などのパラメータをサポートします。

申請プロセス

Sora Videos Generation API を使用するには、まず Ace Data Cloud コンソールにアクセスして API トークンを取得し、保管してください。

まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソールで一般残高をチャージできます。

📘 完全なドキュメント：Sora Videos Generation API →

基本使用（Version 1）

まず、Version 1 の基本的な使用方法を理解します。これは、プロンプト prompt、参考画像リンクの配列 image_urls、およびモデル model を入力することで、処理された結果を得ることができます。具体的な内容は以下の通りです：

ここでは、リクエストヘッダーを設定しています。これには以下が含まれます：

accept：受け取りたいレスポンスの形式。ここでは application/json、つまり JSON 形式を指定します。
authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。

さらに、リクエストボディを設定しています。これには以下が含まれます：

model：生成する動画のモデル。sora-2（標準モード）と sora-2-pro（HD モード）をサポートします。sora-2-pro は 25 秒の動画をサポートしますが、sora-2 は 10 秒と 15 秒のみサポートします。
size：動画の解像度。small は標準解像度、large は HD 解像度（Version 1 のみ）。
duration：動画の長さ。10、15、25 秒をサポートし、25 秒は sora-2-pro のみサポートします（Version 1 のみ）。
orientation：アスペクト比の方向。landscape（横向き）、portrait（縦向き）をサポートします（Version 1 のみ）。
image_urls：参考画像リンクの配列。画像から動画を生成するために使用します（Version 1 のみ）。
character_url：キャラクタービデオのリンク。動画に実在の人物が表示されてはいけません（Version 1 のみ）。
character_start/character_end：キャラクターが表示される開始および終了の秒数。範囲の差は 1-3 秒です（Version 1 のみ）。
prompt：プロンプト（必須）。
callback_url：非同期コールバック結果の URL。
async：オプション。true に設定すると、インターフェースはすぐに task_id を返し、callback_url を提供する必要がなくなります。その後、対応するタスククエリインターフェースを使用して結果をポーリングして取得します。
version：API バージョン、"1.0"（デフォルト）または "2.0"。

選択後、右側にも対応するコードが生成されていることがわかります。以下のように示されています：

「Try」ボタンをクリックするとテストが行えます。上の図のように、以下の結果が得られました：

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "sora-2:task_01k7770rgsevxsmtpbn7xnm5gh",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k7770rgsevxsmtpbn7xnm5gh%2Ftask_01k7770rgsevxsmtpbn7xnm5gh_genid_0bf958d3-cae7-4298-b7b6-99ae439a1ea6_25_10_10_14_06_975715%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A30%3A38Z&se=2025-10-16T13%3A30%3A38Z&sks=b&skt=2025-10-10T12%3A30%3A38Z&ske=2025-10-16T13%3A30%3A38Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=8ebb0df1-a278-4e2e-9c20-f2d373479b3a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=jigY6Z5qp8%2BTXYobaW0EAJ4%2Fbx6G7t6V1P0iyDeUq48%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

返された結果には複数のフィールドがあり、以下のように説明されます：

success：この時点での動画生成タスクの状態。
task_id：この時点での動画生成タスクID。
trace_id：この時点での動画生成トレースID。
data：この時点での動画生成タスクの結果リスト。
- id：この時点での動画生成タスクの動画ID。
- video_url：この時点での動画生成タスクの動画リンク。
- state：この時点での動画生成タスクの状態。

満足のいく動画情報が得られたことがわかります。結果の data の動画リンクアドレスに基づいて生成された Sora 動画を取得するだけです。また、対応する接続コードを生成したい場合は、生成されたコードを直接コピーできます。例えば、CURL のコードは以下の通りです：

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "size": "large",
  "duration": 15,
  "orientation": "landscape",
  "prompt": "cat running on the river",
  "model": "sora-2"
}'

画像から動画生成タスク（Version 1）

画像から動画生成タスクを行いたい場合、まずパラメータ image_urls に参考画像リンクを渡す必要があります。以下の内容を指定できます：

image_urls：この画像から動画生成タスクで使用される参考画像リンクの配列。実在の人物の画像を渡すことはできませんので、注意してください。

記入例は以下の通りです：

記入が完了すると、自動的に以下のコードが生成されます：

対応するコード：

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "large",
    "duration": 15,
    "orientation": "landscape",
    "prompt": "川で走る猫",
    "model": "sora-2",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

クリックして実行すると、すぐに結果が得られます。以下のようになります：

{
  "success": true,
  "task_id": "dd392ff0-dcb7-4c7a-afd0-9bd4f65c803a",
  "trace_id": "04fd151c-e942-4c1c-a6ab-9a1b1fe54172",
  "data": [
    {
      "id": "sora-2:task_01k777af4hfmg9g7yfvwsc6zws",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777af4hfmg9g7yfvwsc6zws%2Ftask_01k777af4hfmg9g7yfvwsc6zws_genid_92bae0c5-1703-4a5f-9d9f-c9ed2f9e7176_25_10_10_14_12_924695%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A37%3A32Z&se=2025-10-16T13%3A37%3A32Z&sks=b&skt=2025-10-10T12%3A37%3A32Z&ske=2025-10-16T13%3A37%3A32Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=5j4dibeaSsDmEka5c%2B9CKHZhRPdqfClQ0tIh03TWXsM%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

生成された効果は画像から動画を生成するもので、結果は上記のように似ています。

キャラクター生成動画タスク（バージョン 1）

キャラクター生成動画タスクを行う場合、まずパラメータ character_url にキャラクター作成に必要な動画リンクを渡す必要があります。動画には必ず実在の人間が映ってはいけません。以下の内容を指定できます：

character_url：キャラクター作成に必要な動画リンク。動画には必ず実在の人間が映ってはいけません。

記入例は以下の通りです：

記入が完了すると、自動的に生成されたコードは以下の通りです：

対応するコード：

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "small",
    "duration": 10,
    "orientation": "landscape",
    "prompt": "川で走る猫",
    "character_url": "https://cdn.acedata.cloud/pdidf5.mp4",
    "model": "sora-2",
    "character_end": 3,
    "character_start": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

クリックして実行すると、すぐに結果が得られます。以下のようになります：

{
  "success": true,
  "task_id": "d9bf5461-29b5-47fd-be90-1fe9197df259",
  "trace_id": "b7992643-9207-40d6-956b-7577728acc67",
  "data": [
    {
      "id": "sora-2:task_01k8ykrztefavaypw6xanw305b",
      "video_url": "https://platform.cdn.acedata.cloud/20251101/bee4eeeb4c4660b46dac4548a1ffbc.mp4",
      "state": "succeeded"
    }
  ]
}

生成された効果はキャラクター生成動画で、結果は上記のように似ています。

バージョン 2.0 モード

上記のバージョン 1.0 モードに加えて、本 API はバージョン 2.0 モードもサポートしています。version パラメータを "2.0" に設定することで有効にできます。バージョン 2.0 モードは、より短い動画の長さとピクセル単位の解像度制御をサポートしています。

バージョン 2.0 パラメータ説明

パラメータ	タイプ	必須	説明
`version`	string	はい	`"2.0"` に設定
`prompt`	string	はい	動画生成のためのプロンプト
`model`	string	いいえ	`sora-2`（デフォルト）または `sora-2-pro`
`duration`	integer	いいえ	動画の長さ：`4`（デフォルト）、`8`、`12` 秒
`size`	string	いいえ	解像度：`720x1280`（デフォルト）、`1280x720`、`1024x1792`、`1792x1024`
`image_urls`	array	いいえ	参照画像 URL 配列、最初の画像のみ使用、画像サイズは `size` パラメータと一致する必要があります
`callback_url`	string	いいえ	非同期コールバック URL

基本的な例

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "version": "2.0",
  "prompt": "川で走る猫",
  "model": "sora-2",
  "duration": 8,
  "size": "1280x720"
}'

対応する Python コード：

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "version": "2.0",
    "prompt": "川で走る猫",
    "model": "sora-2",
    "seconds": 8,
    "size": "1280x720"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

対応する JavaScript コード：

const response = await fetch('https://api.acedata.cloud/sora/videos', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'authorization': 'Bearer {token}',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    version: '2.0',
    prompt: '川で走る猫',
    model: 'sora-2',
    seconds: 8,
    size: '1280x720'
  })
});
const data = await response.json();
console.log(data);

返される結果の形式はバージョン 1 と同じです：

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "c0cc8dad-0954-421f-be8d-02eb063b3263",
      "video_url": "https://platform.cdn.acedata.cloud/sora/xxxxx.mp4",
      "state": "succeeded"
    }
  ]
}

使用参考画像（Version 2.0）

Version 2.0 モードでは、image_urls パラメータを使用して参考画像を渡すことで、動画生成を誘導できます（最初の画像のみ使用）：

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "version": "2.0",
    "prompt": "美しい庭を歩いている人",
    "model": "sora-2",
    "duration": 4,
    "size": "1280x720",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

注意：参考画像のサイズは size パラメータと一致する必要があります。例えば、size が 1280x720 の場合、参考画像のサイズも 1280×720 である必要があります。

Version 1.0 と Version 2.0 パラメータ比較

パラメータ	Version 1.0	Version 2.0
`version`	1.0（デフォルト）	2.0
`prompt`	✅	✅
`model`	✅ sora-2 / sora-2-pro	✅ sora-2 / sora-2-pro
`duration`	✅ 10/15/25 秒	✅ 4/8/12 秒
`orientation`	✅ landscape/portrait	❌
`size`	✅ small/large	✅ 720x1280/1280x720/1024x1792/1792x1024
`image_urls`	✅ 複数の参考画像	✅ 最初の画像のみ使用
`character_url`	✅	❌
`callback_url`	✅	✅

非同期コールバック

Sora Videos Generation API の生成時間は比較的長く、約 1-2 分かかります。API が長時間応答しない場合、HTTP リクエストは接続を維持し続け、追加のシステムリソースを消費するため、本 API では非同期コールバックのサポートも提供しています。全体の流れは次の通りです：クライアントがリクエストを発行する際に、追加で callback_url フィールドを指定します。クライアントが API リクエストを発行した後、API はすぐに結果を返し、task_id フィールド情報を含み、現在のタスク ID を示します。タスクが完了すると、生成された動画の結果が POST JSON 形式でクライアントが指定した callback_url に送信され、その中にも task_id フィールドが含まれているため、タスク結果を ID で関連付けることができます。以下の例を通じて、具体的にどのように操作するかを理解しましょう。まず、Webhook コールバックは HTTP リクエストを受信できるサービスであり、開発者は自分が構築した HTTP サーバーの URL に置き換える必要があります。ここでは、デモのために公開の Webhook サンプルサイト https://webhook.site/ を使用します。このサイトを開くと、Webhook URL を取得できます。

この URL をコピーすれば、Webhook として使用できます。このサンプルは https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa です。次に、callback_url フィールドを上記の Webhook URL に設定し、対応するパラメータを入力します。具体的な内容は以下の通りです：

実行ボタンをクリックすると、すぐに結果が得られます。以下のようになります：

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

少し待つと、https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa で生成された動画の結果を確認できます。

内容は以下の通りです：

{
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
        {
            "id": "sora-2:task_01k777hjrbfrgs2060q5zvf2a5",
            "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777hjrbfrgs2060q5zvf2a5%2Ftask_01k777hjrbfrgs2060q5zvf2a5_genid_b8e2e5d1-a579-49ca-a21c-cb3869685cce_25_10_10_14_15_147334%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A38%3A49Z&se=2025-10-16T13%3A38%3A49Z&sks=b&skt=2025-10-10T12%3A38%3A49Z&ske=2025-10-16T13%3A38%3A49Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=p4aMqXqkP%2FI1IhOVGCB9JL8vUUvfNBBF12ESpKhKXOk%3D&az=oaivgprodscus",
            "state": "succeeded"
        }
    ]
}

結果には task_id フィールドが含まれており、他のフィールドは上記と似ています。このフィールドを通じてタスクの関連付けが可能です。

エラーハンドリング

API を呼び出す際にエラーが発生した場合、API は対応するエラーコードとメッセージを返します。例えば：

400 token_mismatched：不正なリクエスト、パラメータが不足または無効な可能性があります。
400 api_not_implemented：不正なリクエスト、パラメータが不足または無効な可能性があります。
401 invalid_token：未認証、無効または不足している認証トークン。
429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

エラー応答の例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "取得に失敗しました"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

結論

この文書を通じて、Sora Videos Generation APIを使用して、入力プロンプトや参考画像を通じて動画を生成する方法を理解したことでしょう。この文書が、APIの接続と使用をより良くする手助けとなることを願っています。ご不明な点がございましたら、いつでも当社の技術サポートチームにお問い合わせください。

はじめに

AIチャット

AI画像

AI動画

AIオーディオ

ウェブ＆データ

CAPTCHA

アイデンティティ

プロキシ

上級

Coding

Sora Videos Generation API 接続説明

申請プロセス

基本使用（Version 1）

画像から動画生成タスク（Version 1）

キャラクター生成動画タスク（バージョン 1）

バージョン 2.0 モード

バージョン 2.0 パラメータ説明

基本的な例

使用参考画像（Version 2.0）

Version 1.0 と Version 2.0 パラメータ比較

非同期コールバック

エラーハンドリング

エラー応答の例

結論

​申請プロセス

​基本使用（Version 1）

​画像から動画生成タスク（Version 1）

​キャラクター生成動画タスク（バージョン 1）

​バージョン 2.0 モード

​バージョン 2.0 パラメータ説明

​基本的な例

​使用参考画像（Version 2.0）

​Version 1.0 と Version 2.0 パラメータ比較

​非同期コールバック

​エラーハンドリング

​エラー応答の例

​結論

申請プロセス

基本使用（Version 1）

画像から動画生成タスク（Version 1）

キャラクター生成動画タスク（バージョン 1）

バージョン 2.0 モード

バージョン 2.0 パラメータ説明

基本的な例

使用参考画像（Version 2.0）

Version 1.0 と Version 2.0 パラメータ比較

非同期コールバック

エラーハンドリング

エラー応答の例

結論