AI Agents

Overview

Renderful supports agent-native workflows for tools like OpenClaw. Register an agent to identify your integration, request quotes before execution, and submit generations through the same API used by direct clients.

Register an Agent

curl -X POST https://api.renderful.ai/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "MyOpenClawAgent",
    "source": "docs",
    "agent_platform": "openclaw",
    "agent_version": "1.0.0"
  }'

Generate with API key or x402

curl -X POST https://api.renderful.ai/api/v1/generations \
  -H "Authorization: Bearer ${RENDERFUL_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text-to-image",
    "model": "flux-dev",
    "prompt": "A cinematic product photo"
  }'

Monitor agent balance

curl -X GET https://api.renderful.ai/api/v1/agents/balance \
  -H "Authorization: Bearer rf_your_api_key"

Developer keys use GET /api/v1/account/balance. Agent keys use GET /api/v1/agents/balance.