renderful-generation

使用 OpenClaw 的 Renderful 进行图像/视频/音频/3D 创建，包括模型发现、生成前报价工作流程、确定性轮询和资金不足/x402 后备。

Use this skill with the Renderful OpenClaw plugin tools:
- `renderful_list_models`
- `renderful_quote`
- `renderful_generate`
- `renderful_get_generation`
- `renderful_register_agent`
- `renderful_get_balance`
- `renderful_set_webhook`

## Recommended Flow

1. Run `renderful_register_agent` if no API key is available.
2. Run `renderful_list_models` to pick a valid `type` and `model`.
3. Run `renderful_quote` before `renderful_generate`.
4. Run `renderful_generate` once inputs are validated.
5. Poll with `renderful_get_generation` until terminal status.

## x402 and Insufficient Funds

- If generation returns `status=402`, surface `payment_requirements`.
- If `needs_funds=true`, surface `deposit_addresses` and `shortfall`.
- Retry generation after funding or after providing valid `x_payment`.

## Notes

- Prefer read-only calls (`list_models`, `quote`, `get_generation`, `get_balance`) until explicit user approval for side effects.
- Keep responses deterministic and structured so planners can chain tool calls safely.

---

## 中文说明

将此技能与 Renderful OpenClaw 插件工具配合使用：
- `renderful_list_models`
- `renderful_quote`
- `renderful_generate`
- `renderful_get_generation`
- `renderful_register_agent`
- `renderful_get_balance`
- `renderful_set_webhook`

## 推荐流程

1. 如果没有可用的 API 密钥，运行 `renderful_register_agent`。
2. 运行 `renderful_list_models` 以选择有效的 `type` 和 `model`。
3. 在 `renderful_generate` 之前运行 `renderful_quote`。
4. 输入验证通过后运行一次 `renderful_generate`。
5. 使用 `renderful_get_generation` 轮询，直到达到终止状态。

## x402 与资金不足

- 如果生成返回 `status=402`，暴露 `payment_requirements`。
- 如果 `needs_funds=true`，暴露 `deposit_addresses` 和 `shortfall`。
- 在充值后或提供有效的 `x_payment` 后重试生成。

## 注意事项

- 在用户明确批准副作用之前，优先使用只读调用（`list_models`、`quote`、`get_generation`、`get_balance`）。
- 保持响应确定性且结构化，以便规划器能安全地链接工具调用。