Story shots
提供中Describe what happens in a scene. Get a shot list: each shot a plain description of the camera and the action, with its length in seconds.
Story shots
入力
descriptionWhat happens in the scene, where and with whom.total_durationSeconds the scene should last (3 to 60).10 sstyleThe visual style, e.g. anime or film noir.location_nameWhere the scene happens.$0.078 per run.
These tools need an API key with the api:opennan scope: paste one under Use API key to run them.
仕組み
- 01Describe the sceneWhat happens, who is in it and where.
- 02We plan the shotsCamera moves and action, checked to flow as one scene.
- 03Get the listPlain descriptions with their lengths, ready to film or generate.
コードから Story shots を呼び出す
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成最初のリクエストを送る
プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。
curl https://api.opennan.com/v1/story/shots \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"description":"A traveler runs toward a train as its doors begin to close.","total_duration":10}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"タスクを確認する
呼び出すとすぐにタスク ID が返ります。終わるまでタスクを確認します:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- ワーカーの空き待ち
- running
- 生成中
- succeeded
- 完了: outputs[].url にファイルがあります
- failed
- 失敗: 料金はかかりません
エラーと直し方
401キーがない、または間違っている
コンソールで作ったキーを Authorization: Bearer ヘッダーで送ってください。
402残高不足
請求ページで残高を追加し、同じ呼び出しをもう一度送ってください。
400受け付けられない値がある
error.message にフィールド名が出ます。パラメーター表の値を使ってください。
429リクエストが多すぎる
数秒待ってから再試行し、429 が続くたびに待ち時間を延ばしてください。
AI アプリに Opennan を追加
一度の設定で、AI が Opennan のすべてのツールを使えます：動画、画像、チャット、音声、音楽、効果音、3D、字幕、吹き替え。お使いのアプリを選んで手順に従ってください。
https:/Codex CLI、Codex アプリ、Codex の IDE 拡張で使えます（共通の ~/.codex/config.toml）。アプリや IDE が OPENNAN_KEY を読めない場合は、キーを書いた config.toml の方法を使ってください。Codex はツールを呼ぶ前に確認するので、承認して続けます。
キーを OPENNAN_KEY として保存
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Opennan プラグインをインストール：サーバーと、モデル選び・価格確認・結果待ちを AI に教えるスキルが入ります
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanまたはサーバーだけを追加
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYまたは ~/.codex/config.toml にこれを追加
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }opennan が一覧にあるか確認
codex mcp listCodex を再起動して、何でも頼んでください
“ネオン街に降る雨の 5 秒動画と、それに合う曲とポスター画像を作って。”
sk-... をご自身のキーに置き換え、他人に見せないでください。キーを持つ人は残高を使えます。キーがなくてもツール一覧は表示できますが、生成にはキーが必要です。
AI エージェントから使う
エージェントに Opennan の MCP サーバーを追加して、このツールを呼び出します。
- ツール
- generate_camera_shots
- 引数の例
{ "description": "A traveler runs toward a train as its doors begin to close.", "total_duration": 10 }
Story shots: よくある質問
Story shots の料金は?
$0.078 per run. The Run button shows the exact price for your input before you start.
コードから呼び出すには?
API キーを付けて POST https://api.opennan.com/v1/story/shots を送ります。タスク ID が返るので、成功か失敗になるまで https://api.opennan.com/v1/tasks/{id} を確認します。
AI エージェントから使えますか?
はい。MCP サーバー https://api.opennan.com/v1/mcp を追加して generate_camera_shots ツールを呼び出すか、エージェントに https://api.opennan.com/llms.txt を読ませてください。
実行が失敗したら?
失敗した実行には料金がかかりません。支払いは結果に対してだけです。
Which API key do I need?
A key with the api:opennan scope. A full api key does not include it: create one with that scope in the console, then use it here under Use API key or in your code.