モデル

呼び出せるモデルにはそれぞれモデル ID があり、createTask の model フィールドに入れます。このページの最後の表に全モデルと最低料金を載せています。モデル名を開くと、パラメーターの全一覧、料金の段階、コピーしてそのまま使えるリクエストがまとまったリファレンスページに移動します。

モデル ID の組み立て

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker はモデルを作った会社やチームです。PopNow 自身のツールは popnow になります。
• model はバージョンの点を残します。seedance-2-0 ではなく seedance-2.0 です。
• task は呼び出しの内容です。text-to-image、edit、image-to-video、reference-to-video、video-extend、text-to-speech、text-to-audio などがあります。画像編集は必ず edit です。

1 つのモデルファミリーには通常、タスクごとに複数の ID があります。送る内容に合わせて選んでください。.../text-to-video はプロンプトだけ、.../image-to-video は開始画像が必要です。

コードからカタログを読む

正しい情報はライブのカタログにあります。いま使えるかどうかと、あなたのアカウントに適用される料金が含まれます。

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

一覧の絞り込み：modality（image、video、audio）、provider、task、search。さらに includeSchema=1 と includeExamples=1 で入力スキーマと検証済みの入力例も付きます。HTTP クライアントがパスパラメーターを 1 セグメントとして扱う場合は、スラッシュを %2F にエンコードしてください。

読んでおきたいフィールド

料金の読み方

credits は popnow.ai に表示されているのと同じ料金で、単位はクレジット（1 クレジット = $0.01）です。

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit は料金の数え方（per_image は 1 枚、per_second は 1 秒、per_request は 1 回、per_1k_characters は 1,000 文字ごと）、perUnit は最低料金です。各ルールはリクエストが when の値に一致したときに適用されます（* は段階を決める設定を表し、ここでは resolution）。タスクの最終請求額は整数のクレジットに切り上げられます。

特定のリクエストの正確な金額は、createTask に送るのと同じ本文で jobs/quote に問い合わせてください。

入力スキーマ

inputSchema は標準の JSON Schema（draft 2020-12）です。どのモデルにも次のルールが当てはまります。

• 未知のフィールドは拒否されます。 aspect_ratio の綴りを間違えると、黙って無視されず 400 になります。
• フィールド名はモデル間で共通です。 同じ意味には常に同じ名前を使います：prompt、negative_prompt、image_url、image_urls、video_url、audio_url、duration_seconds、aspect_ratio、resolution、seed、generate_audio。
• 既定値は自動で入ります。 変えたいものだけを送ってください。
• メディアのフィールドは、公開 HTTPS リンク、アップロードした popnow:// ファイル、保存済みアセットを受け付けます。メディアを参照してください。
• 表示用のヒントは各プロパティの x-ui オブジェクトにあります（ラベル、順序、スライダーの刻み）。検証には影響しません。知らないキーは無視してください。

seed を持つモデルで省略すると、ランダムな値が選ばれてタスクの input に返されるので、気に入った結果を再現できます。

キャッシュ

カタログのレスポンスはアカウント専用で、60 秒間キャッシュできます。一覧は数分キャッシュし、モデルの version が変わったらそのモデルを読み直し、available: false は「あとで試すか別のモデルに切り替える」と扱うのがよいでしょう。

呼び出せる全モデル

料金は単位あたりの最低段階です。解像度を上げる、長くする、オプションを足すと高くなります。各モデルのページにすべての段階があります。