Renderful AI

使用 renderful.ai API 生成 AI 图像与视频。支持加密货币支付（Base / Polygon / Solana）。

API 基础 URL

https://api.renderful.ai/v1

认证

请前往 https://renderful.ai/dashboard 获取 API 密钥。

# 设置为环境变量
export RENDERFUL_API_KEY="rf_your_api_key"

快速开始

生成图像

curl -X POST https://api.renderful.ai/v1/generate 
  -H "Authorization: Bearer $RENDERFUL_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "model": "flux-dev",
    "prompt": "a cat astronaut floating in space, cinematic lighting",
    "width": 1024,
    "height": 1024,
    "steps": 28
  }'

生成视频

curl -X POST https://api.renderful.ai/v1/generate 
  -H "Authorization: Bearer $RENDERFUL_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "model": "kling-1.6",
    "prompt": "a serene mountain landscape at sunset, camera slowly panning",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

可用模型

图像模型

视频模型

图像生成参数选项

{
  "model": "flux-dev",
  "prompt": "必填 — 您的图像描述",
  "negative_prompt": "选填 — 需排除的内容",
  "width": 1024,
  "height": 1024,
  "steps": 28,
  "seed": 42,
  "format": "png"
}

视频生成参数选项

{
  "model": "kling-1.6",
  "prompt": "必填 — 您的视频描述",
  "duration": 5,
  "width": 1280,
  "height": 720,
  "fps": 24,
  "seed": 42
}

查询生成任务状态

curl https://api.renderful.ai/v1/status/{task_id} 
  -H "Authorization: Bearer $RENDERFUL_API_KEY"

响应格式

{
  "task_id": "rf_abc123",
  "status": "completed",
  "url": "https://cdn.renderful.ai/generated/abc123.png",
  "expires_at": "2026-02-02T12:00:00Z"
}

定价

支持在 Base、Polygon 或 Solana 网络上使用 USDC 支付。最新费率请访问：https://renderful.ai/pricing

x402 集成

Renderful 支持 x402 支付协议，以实现 Agent 的自主付费能力：

# Agent 可在无需人工审批的情况下直接完成支付
export RENDERFUL_X402_WALLET="your_agent_wallet"
export RENDERFUL_PREFER_X402="true"

错误处理

示例

简单图像生成

curl -X POST https://api.renderful.ai/v1/generate 
  -H "Authorization: Bearer $RENDERFUL_API_KEY" 
  -d '{"model":"flux-dev","prompt":"a cute cat","width":512,"height":512}'

指定参数的视频生成

curl -X POST https://api.renderful.ai/v1/generate 
  -H "Authorization: Bearer $RENDERFUL_API_KEY" 
  -d '{
    "model": "kling-1.6",
    "prompt": "underwater coral reef, fish swimming, sunlight rays",
    "duration": 5,
    "width": 1920,
    "height": 1080
  }'

使用建议

• 使用更详尽的提示词可获得更优结果
• 在提示词中加入风格描述（如 “cinematic”、“photorealistic”、“anime”）
• 合理使用 negative prompt 排除不期望的元素
• 视频生成耗时较长（通常为 30–120 秒），请务必调用 /status 接口轮询任务状态