image-skill
Image Skill
Status: live preview hosted-product contract. Created by agents, for agents to create.
Image Skill is a hosted creative-media runtime: image, video, audio, and 3D generation and editing through one thin CLI and HTTP API. Agents do not bring provider keys, log in, run an MCP server, or wire per-provider billing. Hosted signup mints and saves a restricted Image Skill token (not a user-supplied provider credential). Every successful call returns a durable owned media URL plus a structured JSON envelope (job id, asset ids, trace id, cost receipt, capability id).
30-second start
JSON is the default. Do not add --json to examples.
npm_config_update_notifier=false npx -y image-skill@latest create --guide --prompt "a compact field camera on a stainless workbench"
The guide is a free, zero-spend planning call. Given current auth, quota, and payment state, it returns data.next_command, data.next_command_copy_runnable, data.next_command_missing_inputs, data.stage, data.guide_warning, data.next_command_effect, data.auth_ready, data.no_spend_evaluation, data.guide_recovery, data.recommended_no_spend_command (alias of data.no_spend_next_command), data.no_spend_next_command_effect, data.self_fund_next_command, data.self_fund_handoff, data.self_fund_preparation, data.auth_handoff, and data.mutation. It also preserves data.checks.quota.top_up, the same quota top-up recommendation returned by usage quota, so wallet-capable agents can see whether a browserless x402 top-up is recommended before the hard wall. Read data.guide_warning before running data.next_command: next_command_safety names whether the command is no-spend setup, read-only inspection, live-money payment action, or live media create. Run that next command only when data.next_command_copy_runnable is true and the warning says it is safe for your spend policy; when it is false, fill data.next_command_missing_inputs first. Prefer data.guide_recovery for no-doc recovery loops: it names the safest no-spend command and field, the live create or payment field that would spend, and the double-spend guard to check before any live retry. Repeat until data.stage is ready_to_create. At ready_to_create, data.auth_ready.ready and data.auth_ready.next_command_auth_ready are true: the returned create can reuse saved config, env token, or stdin token context without exposing a raw token. Read data.self_fund_preparation in this stage before spending the remaining free allowance: when available is true, it mirrors top-up urgency, urgency_score, and urgency_reasons; when recommended is true, quote_command creates an authenticated live-money quote/payment object but does not pay, settle a wallet transfer, debit credits, call a provider, or write media. When that quote is copy-runnable, data.self_fund_next_command aliases it with a pre_wall_... label such as pre_wall_browserless_agent_payable_quote, so you can open the quote path before the quota wall. Only a later buy/payment step can spend money. When data.guide_warning.next_command_safety is live_media_create_credit_debit and data.no_spend_evaluation.stop_here is true, data.next_command is the live create: run it only if media spend is allowed, otherwise stop before it and run data.recommended_no_spend_command for no-spend proof. The no-spend command is an authenticated hosted dry-run: it may create a recoverable job.planned receipt, but it has no provider call, credit debit, downloadable asset, or media write.
When data.stage is quota_required, data.self_fund_handoff mirrors top-up urgency, urgency_score, and urgency_reasons, and exposes first_safe_command with a no-spend inspection effect. Run that no-spend command first when you need to inspect rails or stay below delegated spend authority before opening the live-money quote path.
Minimum success envelope on a create or edit: