動画を生成
提出するとHTTP 202が返され、ShareAIジョブIDとポーリングURLが提供されます。.
このページについて
https://api.shareai.now/api/v1/videos動画を生成
- ベースURL
https://api.shareai.now- 認証
- Bearer APIキーまたは承認済みOAuthアクセストークン
- 必須スコープ
inferenceormonetization_gateway
提出はHTTP 202を返し、ShareAIジョブIDとポーリングURLを提供します。安定した Idempotency-Key ヘッダーを送信して同じリクエストを再試行します。異なる入力でそのキーを再利用すると拒否されます。同じ発信資格情報でポーリングしてください。状態には、queued、pending、in_progress、finalizing、completed、failed、requires_reviewが含まれます。requires_reviewの結果はチームによる調整が必要であり、ポーリングは新しい生成を開始しません。 GET /api/v1/videos/{id} 秒単位でのオプションの動画の希望する長さ(1~600秒)、選択されたモデルによってさらに制限されます。実際に返された長さが長さの請求を決定します。.
始める前に#
サーバーにSHAREAI_API_KEYを設定し、モデルプレースホルダーを現在有効なモデルに置き換えてください。APIキーをブラウザコードで公開しないでください。モデル、アカウント、資格情報、プロバイダーはすべてこの操作を許可する必要があります。以下のオプション設定はモデルのサポートが必要です。APIの安全範囲は、すべてのモデルがすべての値をサポートすることを保証するものではありません。.
リクエストを送信#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);リクエストフィールド#
| フィールド | タイプ | 意味と制限 |
|---|---|---|
model 必須 | 文字列 | 有効な公開モデル識別子を正確に指定してください。この操作を宣言し、資格情報で許可されている必要があります。. |
prompt 必須 | 文字列 | 空でない生成プロンプト、最大256 KiBのUTF-8テキスト。. |
duration | 整数 | オプションの動画サウンドトラックセレクター。モデルのサポートと対応する料金バリアントが必要です。. |
resolution | 文字列 | モデル対応の解像度セレクター、最大100文字;公開されている料金プランのバリアントと一致する必要があります。. |
aspect_ratio | 文字列 | モデル対応のアスペクト比セレクター、最大100文字。. |
size | 文字列 | モデル対応の出力サイズ、最大100文字。例: 1024×1024。このオプションをサポートしていないモデルもあります。. |
generate_audio | ブール値 | 最大2つのimage_urlパーツを使用可能で、それぞれframe_typeがfirst_frameまたはlast_frameである必要があります。重複は不可です。frame_imagesとinput_referencesを組み合わせないでください。. |
seed | 整数 | オプションのモデル対応シード。動画の場合は非負整数が必要で、再現性は実行者に依存します。. |
frame_images | 配列 | 動画のみ。明示的にtrueを指定すると、一時的な上流結果保持が必要なルートで許可されます。省略/falseの場合、それらのルートは利用不可のままです。provider.zdr:trueと競合します。他の操作では必須のZDRを保持します。. |
input_references | 配列 | 最大16個の型付きimage_url部分で、image_url.urlはHTTPS URLまたはサポートされている画像データURLに設定されます。モデルのサポートが必要です。. |
provider | オブジェクト | オプションのプロバイダールーティング設定。プロバイダータグを受け入れる場合はprovider.onlyを使用してください。モデルIDのプレフィックスとして使用しないでください。アカウントと資格情報の制限は依然として適用されます。. |
allow_temporary_retention | ブール値 | 成功するとHTTP 202とJSONを返します。提出はHTTP 202を返し、ShareAIジョブIDとポーリングURLを提供します。安定した. |
結果を読む#
動画ルートは請求単位を宣言します。秒単位のルートは、返されたファイルの測定された長さを使用して決済され、要求された長さや上流のUSDコストは使用されません。要求された長さは1~600秒の範囲内であり、モデルによってサポートされる必要があります。保守的なクレジット保持は最大4つの出力をカバーできます。 Idempotency-Key ヘッダーを送信して同じリクエストを再試行します。異なる入力でそのキーを再利用すると拒否されます。同じ発信資格情報でポーリングしてください。状態には、queued、pending、in_progress、finalizing、completed、failed、requires_reviewが含まれます。requires_reviewの結果はチームによる調整が必要であり、ポーリングは新しい生成を開始しません。 GET /api/v1/videos/{id} 秒単位でのオプションの動画の希望する長さ(1~600秒)、選択されたモデルによってさらに制限されます。実際に返された長さが長さの請求を決定します。.
請求単位#
一部の動画ルートでは、一時的な上流保持が必要であり、生成された結果を取得するために必要です。それらはその動画リクエストで明示的な.
Consoleから正確な有効モデル識別子を選択してください。その宣言された操作と入出力機能がこのエンドポイントに一致する必要があります。テキストチャットモデルを別の操作に代用することはできません。資格情報、プロバイダー、アカウントの制限は依然として適用されます。.
料金と使用状況#
料金は選択されたモデル、プロバイダー、単位、バリアントに対してEUR AIクレジットで公開されます。そのアクティブな料金の次元のみが請求されます。見積もりは実行前にクレジットを予約します。最終的な請求は測定された使用量を使用します。料金は解像度、出力形式、または使用帯域によって異なる場合があります。最終的なShareAIのデビットはConsole Usageで確認してください。上流のコストフィールドやメディアバイトは、発明されたトークン数に変換されません。.
アクセスとエラー#
使用する inference 承認されたネットワークコスト推論または monetization_gateway 承認されたBuilderのマークアップおよび受け入れられた請求条件に基づきます。アイデンティティのみのアクセスでは支出は許可されません。検証、モデル認証、不足クレジット、レート制限、実行失敗は構造化された error. タイムアウトや送信の不確実性が発生した場合、別の有料リクエストを作成する前にUsageまたはビデオジョブを確認してください。.
一時的な動画保持#
承認が必要です。それを省略すると、それらのルートは利用不可のままです。この例外は動画のみに適用され、他の操作のモデルトレーニングや保持を許可することはありません。明示的なZDRポリシーは黙って弱めることはできません。 allow_temporary_retention:true 発信資格情報を使用して動画生成を読み取る.
JSON
{"allow_temporary_retention": true}ジョブステータスを確認#
https://api.shareai.now/api/v1/videos/{id}上記のJSONは安定したジョブフィールドを示しており、実際の生成ではありません。同じキーでShareAIパスをポーリングし、チェック間で待機します。queued、pending、in_progress、finalizingは待機を意味し、completedはShareAIコンテンツURLでデータを公開します。failedとrequires_reviewは停止して検査を意味します。一時的なエラー後にステータスを再試行しますが、生成を自動的に再提出しないでください。異なる資格情報や取り消された資格情報ではジョブを取得できません。
- ベースURL
https://api.shareai.now- 認証
- Bearer APIキーまたは承認済みOAuthアクセストークン
- 必須スコープ
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}完了すると、各データエントリにはShareAIコンテンツURLが含まれます。同じ発信資格情報を使用して取得してください。エンドポイントは単一のHTTPバイト範囲をサポートします。プロバイダーURL、プライベートチケット、プロバイダー資格情報は返されません。ポーリングとダウンロードは2回目の推論リクエストやMonetization Gatewayの取り込み料金を発生させません。完了したジョブは、ファイルがダウンロード可能になる前に決済が確認されていることを意味します。.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"結果をダウンロード#
完了すると、各データエントリにはShareAIコンテンツURLが含まれます。取得 GET /api/v1/videos/{id}/content?index=0 同じ発信元の資格情報を使用します。エンドポイントは単一のHTTPバイト範囲をサポートします。プロバイダーURL、プライベートチケット、およびプロバイダー資格情報は返されません。ポーリングとダウンロードは、2回目の推論リクエストや収益化ゲートウェイの取り込み料金を発生させません。完了したジョブは、ファイルがダウンロード可能になる前に決済が確認されることを意味します。.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4オプションのframe_imagesには、first_frameまたはlast_frameを含むimage_urlパーツが必要です。1つのリクエストでフレーム画像または参照画像のいずれかを使用し、両方を同時に使用することはできません。モデルの再生時間、解像度、アスペクト比は、APIの安全範囲よりも制限される場合があります。Webhookや任意のコールバックURLはサポートされていません。.
最終更新日 2026年11月3日