🎨图像 API已上线

recraft-v4 API

Recraft V4 已通过 API in One 接入真实生产路由 /api/v1/images/generations,后端节点为 node78。一个 API Key 即可调用并按成功请求计费。

Model IDrecraft-v4

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型:text

鉴权Bearer API Key

密钥由共享 Dashboard 管理。

Webhook不需要

该路由不依赖 webhook。

真实能力

以下能力来自当前已接入的模型配置和后端路由,不展示未上线 API。

稳定生产路由

Vector (SVG) output support

统一接口

4 quality tiers for different needs

透明计费

Design-focused with style control

快速接入

Brand-consistent output

请求方式

浏览器端只调用同源 API,服务端 BFF 再转发到对应 Worker。

参数

promptstring

Text description of the image

必填
modelstring

Sub-model: "recraft-v4-text-to-image" (10cr), "recraft-v4-text-to-vector" (20cr), "recraft-v4-pro-text-to-image" (60cr), "recraft-v4-pro-text-to-vector" (70cr)

可选 · 默认 recraft-v4-text-to-image
image_sizestring

Image dimensions (e.g. "1024x1024")

可选 · 默认 1024x1024

示例请求

curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "recraft-v4-text-to-image",
  "prompt": "A minimalist line art illustration of a mountain landscape, clean design",
  "image_size": "1024x1024"
}'

同端点可切换模型

这些模型使用同一个已实现 BFF endpoint,可通过请求体中的 model 字段切换。

接入流程

这些步骤基于当前真实路由和共享账号体系,不新增独立登录、支付或订单流程。

01

创建共享 API Key

在现有 Dashboard 创建密钥,充值、订单、积分和个人信息仍走共享控制台。

02

调用真实端点

使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/images/generations

03

查询任务状态

异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。

任务状态查询

图像、视频、音频和工具任务创建后,使用真实任务端点查询结果。

GET/api/v1/tasks/{task_id}查询生成任务状态和结果。

价格

10–70 credits per image (~$0.10–$0.70)

基础价格$0.10
积分10
计费按成功请求

使用场景

这些场景可通过当前模型和对应后端节点实现。

01

Generate brand-consistent marketing assets

02

Create icon sets and UI illustrations

03

Produce design mockups and concept art

04

Build AI design tools with style control

常见问题

How much does Recraft V4 cost?

Depends on sub-model: recraft-v4-text-to-image (10cr), recraft-v4-text-to-vector (20cr), recraft-v4-pro-text-to-image (60cr), and recraft-v4-pro-text-to-vector (70cr).

What makes Recraft V4 different?

Recraft V4 is specifically designed for design workflows. It supports both raster and vector (SVG) output with standard and pro quality tiers.

Can I generate vector images?

Yes. Use recraft-v4-text-to-vector or recraft-v4-pro-text-to-vector to generate vector (SVG) output.

相关真实模型