はじめに
Astra は拡大とともに見た目を変えてよいカットに使います。AI で作った室内やスタイルのある映像に新しい素材感を与え、記録の復旧ではなく一つの映像解釈として採否を判断します。
主な機能とハイライト
3 段階の創造性と任意の説明文でモデルの自由度を決めます。出力は 720p、1080p、4K で、間に 2K の選択肢はありません。
セラーの low・文章なしの試行では髪やグラスの縁が増え、目と横顔も変わりました。3 秒の 1080p 処理は約 210 秒で、控えめな設定でも顔が変化しました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | リンクまたはアップロードで 1–60 秒の MP4 を渡します。短い素材も長い素材も範囲外なら受理前に拒否し、創作版でも元の尺と音声を維持します。 1 文字以上 |
prompt | いいえ | 画面にあるものや希望する仕上がりを説明する任意の文章です。空欄では画像を手掛かりに解釈し、説明の追加で単価は変わりません。 2000 文字以内 |
resolution | いいえ |
|
creativity_level | いいえ | 既定の |
料金
Astra の単価とステップ長は出力解像度で決まり、プロンプトや創造性では変わりません。入力時間を次の整数秒、続いて次の完全なステップに切り上げ、最低 1 ステップとします。表示単価はステップ価格を時間で割ります。実測したアップロードかリンクの 60 秒分を確保し、完了後に余分を戻し、失敗は無料です。720p と 1080p は同額で、4K は高くなります。
| 仕様 | 料金 |
|---|---|
| $0.36 / 秒 |
| $0.36 / 秒 |
| $0.60 / 秒 |
ユースケース
演出を重視した挿入カットでは、衣服やガラスを作品の方向性と前後の映像に照らして比較します。
AI 動画の仕上げでは、重要な人物や物の見え方を承認してから複数の納品サイズを依頼します。
プロンプトガイドと実践のヒント
まず low で文章なしの版を作ります。方向付けが必要なら、見えている素材や光を一貫した短文で説明し、試行ごとに一つの設定だけ変えます。
首の回転や動く質感を再生してから出来を決めます。その後に最終サイズを選び、元の音声が残っていることも確認します。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "topaz/astra/upscale",
"input": {
"creativity_level": "low",
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
