Renderful AI

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

API基础URL

https://api.renderful.ai/v1

身份验证

从 https://renderful.ai/dashboard 获取API密钥

bash

设置为环境变量

export RENDERFULAPIKEY=rfyourapi_key

快速开始

生成图像

bash
curl -X POST https://api.renderful.ai/v1/generate \
-H Authorization: Bearer $RENDERFULAPIKEY \
-H Content-Type: application/json \
-d {
model: flux-dev,
prompt: 一只在太空中漂浮的宇航员猫，电影级布光,
width: 1024,
height: 1024,
steps: 28
}

生成视频

bash
curl -X POST https://api.renderful.ai/v1/generate \
-H Authorization: Bearer $RENDERFULAPIKEY \
-H Content-Type: application/json \
-d {
model: kling-1.6,
prompt: 日落时分的宁静山景，镜头缓慢平移,
duration: 5,
width: 1280,
height: 720
}

可用模型

图像模型

模型	描述	最佳用途
flux-dev	FLUX.1 Dev	通用用途，高质量
flux-schnell

FLUX.1 Schnell | 快速生成 | | flux-pro | FLUX.1 Pro | 最高质量 | | sdxl | Stable Diffusion XL | 经典扩散模型 | | gemini-3 | Gemini 3 Pro Image | Google图像生成 | | grok-imagine | Grok Imagine | X/Twitter集成 | | seedream | Seedream 4.5 | 亚洲美学风格 | | reve | Reve Image | 艺术风格 |

视频模型

模型	描述	时长
kling-1.6	Kling 1.6	最长10秒
kling-1.5

Kling 1.5 | 最长10秒 | | veo-3 | Google Veo 3 | 最长8秒 | | veo-2 | Google Veo 2 | 最长8秒 | | seedance | Seedance 1.5 | 最长10秒 | | wan-2.5 | Wan 2.5 | 最长10秒 | | ltx | LTX Video | 最长10秒 | | omnihuman | OmniHuman | 人像视频 |

图像生成选项

json
{
model: flux-dev,
prompt: 必填 - 您的图像描述,
negative_prompt: 可选 - 需要避免的内容,
width: 1024,
height: 1024,
steps: 28,
seed: 42,
format: png
}

视频生成选项

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

检查生成状态

bash
curl https://api.renderful.ai/v1/status/{task_id} \
-H Authorization: Bearer $RENDERFULAPIKEY

响应格式

json
{
taskid: rfabc123,
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支付，实现代理自主操作：

bash

代理可直接支付，无需人工审批

export RENDERFULX402WALLET=youragentwallet
export RENDERFULPREFERX402=true

错误处理

状态码	含义
200	成功
402

需要支付（x402流程） | | 429 | 频率限制 | | 500 | 生成失败 |

示例

简单图像

bash curl -X POST https://api.renderful.ai/v1/generate \ -H Authorization: Bearer $RENDERFULAPIKEY \ -d {model:flux-dev,prompt:一只可爱的猫,width:512,height:512}

指定设置的视频

bash curl -X POST https://api.renderful.ai/v1/generate \ -H Authorization: Bearer $RENDERFULAPIKEY \ -d { model: kling-1.6, prompt: 水下珊瑚礁，游动的鱼群，阳光射线, duration: 5, width: 1920, height: 1080 }

提示

• - 使用详细的提示词可获得更好的效果
• 包含风格描述词（电影级、照片级真实感、动漫）
• 负面提示词有助于避免不需要的元素
• 视频生成需检查状态（耗时30-120秒）