運用

本番運用チェックリスト

コスト、タスク、Webhook、エラー復旧を備えた堅牢な生成連携の準備。

約 1 分2 セクション

本番対応は API 呼び出しの前に始まります。入力を検証し、価格を見積もり、taskId を保存し、結果を非同期で扱います。

実践の要点

速度、忠実度、解像度、制御性のどれを優先するかでモデルを選び、各結果のパラメータとバージョンを保存します。 the model selected for the task — Production checklist.

1 回の試行で変えるのは 1 点だけにします。良い出力を参照として残すと、次の反復で最も確実な出発点になります。

finished と failed は終端状態として扱います。polling または webhook を使い、生のエラーはサーバー側に保持し、利用者には安全なメッセージを表示してください。

プロンプトと API の例

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast

自分の API キーで試す

このガイドで扱うモデルはすべて API Stock のカタログで利用できます。API キーは 1 つ、プリペイド残高も 1 つで、プロバイダーごとの登録は不要です。

カタログを見る API リファレンス

続けて読む

実践の要点

1 回の試行で変えるのは 1 点だけにします。良い出力を参照として残すと、次の反復で最も確実な出発点になります。

プロンプトと API の例

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

json

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast