PopNowAPI ドキュメント
API 残高と請求
本文

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・互換 APIAPI 残高
API モデルページの PlaygroundAPI 残高
開発者向け 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}}'
Python
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")
JavaScript
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 の請求 を開くかサポートに問い合わせてください。

このページの内容