請求

Credit Schedule

Signal Foundry の operation ごとの credit 消費、無料境界、再試行ルールを固定します。

このページの内容8項目

このページは、Signal Foundry の credit contract です。

credit は request 数ではありません。source -> row -> column -> evidence -> run の中で、Signal Foundry が保存済み row、追加 column、または evidence を作る時に使います。

まず見る command

sf credits balance --json
sf credits summary --json
sf data capabilities --json

見る key:

balance.available_credits
balance.remaining_credits
balance.reserved_credits
balance.grants[]
summary.used_credits
summary.meterBreakdown[]
summary.usageBreakdown[]
capabilities.credits.status

credits balance は「今実行できるか」を見ます。credits summary は「何が credit event を作ったか」を見ます。

Plan grant

契約と credit grant の単位は team workspace です。1 人で使う場合も、owner だけの team workspace が API key、List、credit、billing の scope になります。

Plan / grant	Scope	Credit	Notes
Free monthly	team workspace	2,000 / month	小規模な試用
Pro monthly	team workspace	20,000 / month	本番利用
Credit Pack 10000	team workspace	10,000 / purchase	3 ヶ月有効

個人向け checkout は通常導線にしません。個人 account は認証 identity と初期設定のために存在し、通常の実行 scope は team workspace です。

Operation schedule

Operation	Credit	無料 / 有料	CLI
`companies search`	0	無料	`sf companies search 7203 --json`
`company profile`	0	無料	`sf company profile jpx_7203 --json`
`company observations`	0	無料	`sf company observations jpx_7203 --json`
`company filings` / `filing show` / `filing compare`	0	無料	`sf company filings jpx_7203 --json`
`observations search`	0	無料	`sf observations search "生成AI" --json`
`list plan`	0	無料	`sf list plan "<query>" --json`
`list estimate`	0	無料	`sf list estimate "<query>" --json`
`list candidates`	0	無料	`sf list candidates --from-estimate <estimateId> --json`
`list materialize`	saved row 数	有料	`sf list materialize --from-estimate <estimateId> --execute --max-credits <n> --json`
`source import` / `inspect` / `map`	0	無料	`sf source import ./companies.csv --json`
`source resolve`	matched row 数	有料	`sf source resolve <sourceId> --execute --max-credits <n> --json`
`source review`	0	無料	`sf source review <sourceId> --status multiple_candidates --json`
`source select`	新規確定 row ごとに 1	有料	`sf source select <sourceId> --row <sourceRowId> --company <companyId> --max-credits 1 --json`
`list enrich --source website`	`found` row 数	有料	`sf list enrich <listId> --source website --execute --max-credits <n> --json`
`list enrich --source parallel`	実行対象 row 数	有料	`sf list enrich <listId> --source parallel --execute --limit <n> --max-credits <n> --json`
`list export`	0	無料	`sf list export <listId> --format csv --output ./exports/list.csv --json`
`list refresh`	0 または paid source 分	条件付き	paid source refresh は `--max-credits` が必要
`research add`	estimate に応じる	条件付き	`sf research add <companyId> --content-file ./note.md --json`
`feedback create`	0	無料	`sf feedback create "..." --json`

preview、estimate、candidate preview、export、feedback は無料です。CSV を置く、headers を見る、mapping するだけでは credit は使いません。

Website enrichment billing

website enrichment は found row だけ enrichment credit を使います。

Result	Credit	Notes
`found`	1	追加 `column` / `evidence` が保存される
`not_found`	0	URL / domain が見つからない
`no_data`	0	source は見えたが保存できる data がない
`skipped`	0	既存 enrichment の再利用や対象外

確認する key:

estimate.estimated_max_credits
estimate.reusable_existing_companies
run.found_count
run.not_found_count
run.no_data_count
run.skipped_count
billing.credits_used
billing.charges_only_found

billing.credits_used は run.found_count を超えません。

実行前の上限

credit-consuming write は、必ず上限を付けます。

CLI:

sf list materialize --from-estimate <estimateId> --execute --max-credits <n> --json
sf list enrich <listId> --source website --execute --max-credits <n> --json
sf source resolve <sourceId> --execute --max-credits <n> --json

HTTP API:

curl -s "$SIGNAL_FOUNDRY_BASE_URL/api/signal-foundry/lists/materialize" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: list-materialize-20260504-001" \
  --data '{
    "estimateId": "<estimateId>",
    "execute": true,
    "maxCredits": 100
  }'

--execute なしでは保存しません。--max-credits なしでは credit-consuming write を実行しません。

Idempotency

同じ write を再試行する場合は idempotency を使います。

Surface	Required	Notes
CLI	command 側で safe retry を扱う。必要なら `--idempotency-key` を指定	失敗時は `error.suggested_next_commands` を見る
HTTP API	`Idempotency-Key` header	`materialize`、`enrich run`、`source resolve`、`source select` で使う

同じ row / company / idempotency key の再試行では二重消費しません。対象、上限、idempotency key を変える場合は別実行として扱います。

復旧方法

Error	次に見る command	復旧
`max_credits_required`	`sf <command> --help`	`--execute --max-credits <n>` を付ける
`max_credits_exceeded`	`sf list estimate "<query>" --json`	query を絞るか、見積もり以上の上限を明示する
`credit_balance_insufficient`	`sf credits balance --json`	grant 残高を確認する
`preview_export_not_allowed`	`sf list materialize --from-estimate <estimateId> --execute --max-credits <n> --json`	saved List にしてから export する
`account_scope_conflict`	`sf auth show --json`	API key の team workspace scope に任せ、request 側の account 指定を外す

unsupported / weak / needs_human が返る場合は、credit を使う実行へ進みません。条件を分解して人間に確認してください。

次に読むページ

team plan: Access Plans
credit ledger: GET /credits/balance
usage summary: Usage Metering
List command: Lists / Research / Credits

請求