API 残高と返金

PopNow API には、ウェブサイトのクレジットとは別の専用 USD 残高があります。API キーによる呼び出し、API キーで接続した MCP、Playground は API USD を使います。OAuth で接続した MCP は引き続きウェブサイトのクレジットを使います。同じモデル・同じ設定なら API とウェブサイトの料金基準は同じですが、残高を移行したり、代わりに使ったりすることはできません。

このページでは API への入金、料金、確保額の解放を説明します。タスクごとの確保、見積もり、上限は API の課金を参照してください。

1 分でわかる API 残高

• 初期残高は $0。 Playground のテストを含む有料リクエストを実行する前に、API billing で API に入金してください。
• 入金は別々です。 ウェブサイトのクレジットパック、ボーナス、特典は API 呼び出しの支払いに使えません。API 資金はウェブサイトの生成や OAuth MCP に使えません。
• 実行前に見積もります。 jobs/quote はタスクを開始せず、expectedChargeUsd と maxChargeUsd を USD の十進数文字列で返します。
• 精算額を確認します。 タスクの settled が true のとき、costUsd が最終 USD 請求額です。失敗・期限切れのタスクは、モデル固有のコンテンツ拒否に対する課金がある場合を除き、確保額が自動で解放されます。

API 資金の入金方法

API billing で、現在利用可能な決済手段による入金と支払履歴を管理できます。キーの作成と管理は、別途 API keys で行います。

ウェブサイトのクレジットパックのボーナス、招待特典、その他のクレジット付与で API 残高が増えることはありません。ウェブサイトのパック容量、返金期間、有効期限は API 入金の条件ではありません。

どの残高を使うか

認証情報と利用する画面によって、支払元が決まります。

一方に入金しても、もう一方の残高は増えません。API リクエストの確保額をまかなえない場合は、ウェブサイトのクレジットを購入するのではなく API に入金してください。

生成の料金の決まり方

モデルごとに料金表があり、オプションごとに設定されています。画像は 1 枚ごと、動画や音声は 1 秒ごと、楽曲は 1 曲ごと、音声合成は 1,000 文字ごとです。料金は、解像度、長さ、品質の段階、そして一部のモデルでは送る参照ファイルの数によって変わります。

API の USD 料金の例です。

モデルから各モデルのリファレンスに移動できます。設定に応じた最新の見積もりを使い、USD の小数精度（小数点以下最大 9 桁）を保ってください。API の請求額を整数のクレジットに丸めないでください。API ページの Playground も同じ API の USD 残高を使います。

何かを実行する前に、正確な金額を確認できます。

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'

import os, requests

quote = requests.post(
    "https://api.popnow.ai/api/v1/jobs/quote",
    headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
    json={
        "model": "minimax/h3/image-to-video",
        "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
    },
    timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")

const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'minimax/h3/image-to-video',
    input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
  }),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);

タスクが失敗したとき

タスクが受け付けられると、考えられる最高 USD 額が API 残高から取り分けられます（確保）。終了時は次のようになります。

確保額の解放で、利用可能な API 資金が戻ります。銀行口座やカードへの支払いの返金ではありません。タスク記録の costUsd と settled で最終 USD 額を確認してください。API の課金を参照してください。

API 決済の返金

API への入金や返金については、API billing を開くかサポートに問い合わせてください。該当する支払いの参照番号やタスク ID を添え、API キーは送らないでください。

出会う可能性のあるエラー

すべてのコードは エラーに一覧があります。

API の呼び出しは、ウェブサイトでの生成より高くなりますか？

いいえ。同じモデル・同じ設定なら料金基準は同じです。API は専用残高から USD で課金し、ウェブサイトの生成や OAuth MCP はウェブサイトのクレジットを使います。残高は別です。

タスクの確保額の解放を依頼する必要がありますか？

いいえ。失敗・期限切れのタスクは、モデル固有のコンテンツ拒否に対する課金がある場合を除き、自動で確保額が解放されます。精算済みの costUsd で最終 USD 額を確認してください。

API への入金を返金してもらえますか？

返金の対象となるか、API の支払いについて相談したい場合は、API billing を開くかサポートに問い合わせてください。

API 資金にもウェブサイトのクレジットの有効期限が適用されますか？

ウェブサイトのクレジットパックや特典の有効期限は、API の条件を定めるものではありません。API 資金については API billing を確認するか、サポートに問い合わせてください。

ウェブサイトのクレジットで API に入金できますか？

いいえ。API billing で API に入金してください。ウェブサイトのクレジットは API に使えず、API 資金はウェブサイトの生成に使えません。残高間の移行もできません。

関連