01Router

Recraft V4 API

Recraft V4: brand-consistent illustrations, icons and design assets.

Recraft·图片可用

低至$0.036/ 张$0.04省 10%

模型 IDrecraft-v4

在 Playground 试用查看 API
text-to-imagedesign

输入

文本

输出

图片

供应商

4 家供应商

Aspect ratio

1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3

近 7 天表现 · 近期请求较少，暂无统计数据。

Recraft V4 价格

价格按单位计费；未指定供应商时，会路由到支持该参数组合且价格最低的供应商。

规格价格（美元）
全部规格
$0.036 / 张
4 积分$0.04省 10%

接入前先试用 Recraft V4

写代码之前，先测试生成效果、对比各供应商价格并预估费用。

供应商
图片
预计费用

输入

prompt
aspect_ratio

结果

空闲
生成结果会显示在这里。

本次请求的各供应商报价

输入提示词即可对比各供应商价格。

Recraft V4 提示词示例

可直接使用的提示词，一键载入 Playground 再调整。

来源
场景分类

共 20 条提示词

Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, color

Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, color

Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, colorful boats in the harbor appearing toy-like, selective focus band across the middle, saturated primary colors of blue red and yellow boats against white buildings, 90mm tilt-shift lens, the familiar made fantastical, Wes Anderson color sensibility

查看更多

Recraft V4 API 文档

该模型的接口、请求字段与可直接运行的调用示例。

Base URL

https://01router.com/api/v1
llms.txt

快速开始

将 API_KEY 设为项目密钥，在服务端运行示例。示例中的媒体地址需替换为您自己的公开地址。

自动路由会选择支持当前请求的供应商。选择指定供应商，可查看它的参数约束和调用示例。

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "recraft-v4",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

接口列表

这里只列出当前模型相关的接口，路径已包含 /api/v1。点击接口可跳转到使用说明。

POST
/api/v1/generations

创建生成任务（扣积分） · 需要 API 密钥

GET
/api/v1/generations/{id}

查询任务；运行中会向上游拉取状态 · 需要 API 密钥

POST
/api/v1/generations/{id}/cancel

取消进行中的生成任务（退还积分） · 需要 API 密钥

POST
/api/v1/quote

对所有供应商报价（不扣费，无需 Key） · 公开 · 无需密钥

POST
/api/v1/images/generations

兼容 OpenAI 的图片生成接口（同步等待结果） · 需要 API 密钥

GET
/api/v1/models/recraft-v4

查询单个模型 · 公开 · 无需密钥

鉴权

以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
获取 API Key

输入参数

使用 Content-Type: application/json 发送请求。模型参数放在 input 中，model、provider、callback_url 放在最外层。

请求体

参数名类型必填说明
modelstring是"recraft-v4"
providerstring否指定供应商；不传则自动路由到最便宜的。可选： fal | replicate | wavespeed | vercel
inputobject是模型参数，字段见下方 input 字段表。
callback_urlstring否可选的公开 HTTPS 回调地址，接收带签名的任务最终结果；仍可通过查询接口获取状态。

input · input 字段

必填字段已明确标记，其他字段省略时使用所列默认值。

参数名类型必填可选值默认值
prompt*string是——
aspect_ratiostring否1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 | 2:31:1
任务回调 →

输出结果

创建任务成功不代表生成完成。保存 id，查询到 succeeded 或 failed 后，读取 outputs 或 error。示例金额仅作说明，实际费用由请求决定。

queued→processing→succeeded / failed

提交后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "recraft-v4",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

完成后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "recraft-v4",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

响应字段

参数名类型必填说明
idstring是任务 ID，用于查询或取消任务。
objectstring是generation
modelstring是recraft-v4
typestring是image
providerstring是供应商
statusstring是queued → processing → succeeded / failed。进入任一终态后停止轮询。
inputobject是模型参数，字段见下方 input 字段表。
outputsstring[]是结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。
errorstring | null是失败原因；无错误时为 null。
creditsnumber是本次请求扣除的积分。
price_usdnumber是本次请求的美元价格。
created_atstring是ISO 8601 格式的任务创建时间。
completed_atstring | null是ISO 8601 格式的完成时间；未完成时为 null。

获取结果

每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存；也可以传 callback_url 接收推送。

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed。进入任一终态后停止轮询。 结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。

取消任务

取消取决于供应商支持情况和任务状态。确认取消后返回 status: failed、error: Canceled by user；不支持取消或已完成的任务返回 409 not_cancelable。

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

报价

请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "recraft-v4",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1"
  }
}
JSON

OpenAI 兼容图片接口

使用 OpenAI SDK 时，可调用此接口并在最外层传入 prompt。它会等待结果并返回 data[].url。异步任务和完整模型参数请使用 /generations。

curl "https://01router.com/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "recraft-v4",
  "prompt": "A cinematic shot of a red fox running through snow"
}
JSON
{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

模型信息与参数

此公开接口返回模型参数，以及各供应商支持的参数约束和价格。

curl "https://01router.com/api/v1/models/recraft-v4"

错误码

结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试；生成任务失败则通过任务本身的 status 和 error 返回。

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400请求体或参数取值不合法

401缺少或无效的 API Key

402积分不足

404模型或任务不存在

409任务无法取消（已结束，或该供应商不支持取消）

429请求过于频繁，请稍后重试

502所有供应商都拒绝了任务（积分已退回）

鉴权、路由、计费与错误码详见 →

交给 AI 使用

将本模型文档交给编程助手：纯文本包含接口、输入约束、输出字段和请求示例。

打开 llms.txt

Recraft V4 与同类模型对比

并排对比规格与起步价，选择前建议用同一提示词实测。

Recraft V4GPT Image 2.5 FlareGPT Image 2.5 SunburstNano Banana 2.1
厂商RecraftOpenAIOpenAIGoogle
起步价$0.036 / 张$0.0053 / 张$0.0053 / 张$0.018 / 张
输入文本文本 · 图片文本 · 图片文本 · 图片
供应商4 家供应商6 家供应商6 家供应商8 家供应商
Aspect ratio1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:31:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:31:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:31:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9

Recraft V4 API 常见问题

Recraft V4 有什么不同？

Recraft V4 是与设计师一起打造的，注重构图、光线和材质，出图更有设计感，文字会作为设计的一部分自然呈现。

这个模型输出矢量图吗？

本接口输出位图。Recraft 的矢量（SVG）模型是单独的产品。

支持哪些比例？

1:1、16:9、9:16、4:3、3:4、3:2 和 2:3。

适合哪些场景？

营销视觉、商品图和杂志风图片、海报、包装、社交媒体素材以及概念设计。

在 01router 上怎么计费？

每张图统一价格，详见价格表。生成失败会退还积分。

相关模型

同一个 API Key 即可调用的其他模型。

图片 · OpenAI

GPT Image 2.5 Flare

OpenAI GPT Image 2.5 Flare: fast everyday generation and editing with precise text rendering.

低至 $0.0053 / 张查看 API
图片 · OpenAI

GPT Image 2.5 Sunburst

OpenAI GPT Image 2.5 Sunburst: tighter control for demanding edits and premium creative.

低至 $0.0053 / 张查看 API
图片 · Google

Nano Banana 2.1

Google Gemini image model: consistent multi-reference editing, 1K–4K output.

低至 $0.018 / 张查看 API
图片 · ByteDance

Seedream 5.0 Pro

ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing.

低至 $0.026 / 张查看 API
图片 · Google

Nano Banana 2

Gemini 3.1 Flash Image: fast generation and editing with strong text rendering, 1K–4K.

低至 $0.036 / 张查看 API
图片 · ByteDance

Seedream 5.0 Flash

Low-latency Seedream 5.0: same price for 1K–2K, up to 10 reference images.

低至 $0.012 / 张查看 API