API 残高と返金
API 専用の USD 残高、モデル料金、タスク確保額の解放、入金の返金に関する問い合わせ先を説明します。
PopNow API には専用の USD 残高があります。API キーによる呼び出し、開発者向け MCP、API ページの Playground がこの残高を使います。同じモデルと同じ設定であれば、API と popnow.ai の料金は同じです。
このページでは API への入金、料金、確保額の解放を説明します。タスクごとの確保、見積もり、上限は API の課金を参照してください。
1 分でわかる API 残高
- 初期残高は $0。 Playground のテストを含む有料リクエストを実行する前に、API の請求 で API に入金してください。
- 入金は API 専用です。 API の請求で追加した API 資金だけがこの残高に入り、API でのみ使われます。
- 実行前に見積もります。
jobs/quoteはタスクを開始せず、expectedChargeUsdとmaxChargeUsdを USD の十進数文字列で返します。 - 精算額を確認します。 タスクの
settledがtrueのとき、costUsdが最終 USD 請求額です。失敗・期限切れのタスクでは、確保額が自動で解放されます。
API への入金と支払履歴
API の請求 で、現在利用可能な決済手段による入金と支払履歴を管理できます。キーの作成と管理は、別途 API キー で行います。
API 残高を使う場面
| 呼び出し・画面 | 支払元 |
|---|---|
sk-popnow- キーによる REST・互換 API | API 残高 |
| API モデルページの Playground | API 残高 |
| 開発者向け MCP(API キー) | API 残高 |
| API または開発者向け MCP で実行する保存済みレシピ | API 残高 |
API リクエストの確保額をまかなえない場合は、API の請求で API 資金を追加してください。
生成の料金の決まり方
モデルごとに料金表があり、オプションごとに設定されています。画像は 1 枚ごと、動画や音声は 1 秒ごと、楽曲は 1 曲ごと、音声合成は 1,000 文字ごとです。解像度、長さ、品質、参照ファイルによって料金が変わる場合があります。
API の USD 料金の例です。
| モデル | 内容 | USD |
|---|---|---|
| Z-Image Turbo | 画像 1 枚 | $0.01 |
| Nano Banana 2.1 | 画像 1 枚、1K / 2K / 4K | $0.048 / $0.072 / $0.162 |
| Seedream 5.0 Pro | 画像 1 枚、1K / 2K | $0.036 / $0.072 |
| MiniMax H3 | 画像から動画、768p、5 秒 | $0.185 |
| Suno v6 | 楽曲 1 曲 | $0.072 |
| Background Remover | 透過 PNG 1 枚 | $0.0048 |
| Image Upscaler | 写真 1 枚の拡大 | $0.012 |
モデルから各モデルのリファレンスに移動できます。設定に応じた最新の見積もりを使い、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`);タスクが失敗したとき
タスクが受け付けられると、発生しうる最大料金が API 残高から確保されます。終了時は次のように処理されます。
| 結果 | 支払う額 |
|---|---|
succeeded | 実際の USD 請求額。確保額を超えることはなく、未使用分は解放されます |
failed または expired | 課金されず、確保額が解放されます |
| コンテンツを理由に拒否 | 課金されません |
開始前に拒否(400、402、403、429 …) | なし。タスクも確保もありません |
確保額の解放で、利用可能な API 資金が戻ります。銀行口座やカードへの支払いの返金ではありません。タスク記録の costUsd と settled で最終 USD 額を確認してください。API の課金を参照してください。
API 決済の返金
API への入金や返金については、API の請求 を開くかサポートに問い合わせてください。該当する支払いの参照番号やタスク ID を添え、API キーは送らないでください。
主なエラーと対処方法
| コード | 意味 | 対処 |
|---|---|---|
40201 | 利用可能な API USD でタスクの確保額をまかなえない | API の請求 で入金するか、解像度、長さ、出力数を下げてください |
40202 | このタスクはキーの利用上限のいずれかを超える | API コンソールで上限を上げるか削除するか、リセットを待ってください |
40901 | 見積もりのあとに料金が変わった | 再度見積もりを取り、新しい USD 料金を表示してください |
すべてのコードは エラーに一覧があります。
API の呼び出しは、ウェブサイトでの生成より高くなりますか?
いいえ。同じモデル・同じ設定なら料金基準は同じです。API は API 残高から USD で課金されます。
タスクの確保額の解放を依頼する必要がありますか?
いいえ。失敗・期限切れのタスクでは、確保額が自動で解放されます。精算済みの costUsd で最終 USD 額を確認してください。
API への入金を返金してもらえますか?
返金の対象となるか、API の支払いについて相談したい場合は、API の請求 を開くかサポートに問い合わせてください。

