Recraft V4.1 Flash
recraft/v4.1/flash/text-to-image- Recraft
- 文生图
- 图片
根据文字描述生成图片。
概览
- 模型开发者
- Recraft
- API 渠道
- fal.ai
- 画幅比例
- 6 种画幅比例
- 支持的协议
fal-task
调用这个模型
创建 API Key、充值账户余额，并在调用前确认密钥有权访问这个模型。
复制此模型的完整接口文档，包含全部已公布协议，供 AI 助手读取。
/v1/tasks/fal请求参数
| 参数 | 必填 | 类型 | 说明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
model | 必填 | string | 使用此处显示的完整公开模型 ID。 约束
| ||||||||||||||||
prompt | 必填 | string | 描述主体、场景和期望生成的内容。 约束
| ||||||||||||||||
image_size | 可选 | string | 选择输出尺寸预设。此网关不接受自定义宽高对象。
约束
| ||||||||||||||||
background_color | 可选 | object | 期望的背景颜色，使用红、绿、蓝分量表示。 | ||||||||||||||||
仅在提供 background_color 时适用；子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||
enable_safety_checker | 可选 | boolean | 是否启用上游安全检查；上游政策可能禁止关闭此选项。
| ||||||||||||||||
colors | 可选 | array<object> | 期望的配色；数组中的每一项均为红、绿、蓝颜色对象。
| ||||||||||||||||
仅在提供 colors 时适用；子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||
size | 可选 | string | image_size 或 resolution 的别名。建议使用本表准确的原生值；像素尺寸别名可能不匹配区分大小写的分辨率值。 | ||||||||||||||||
parameters | 可选 | object | 本表原生参数的另一种容器写法；同一设置不可重复填写不同值。 | ||||||||||||||||
metadata | 可选 | object | 另一种容器写法：将原生参数放在 metadata.parameters 内。 | ||||||||||||||||
调用注意事项
- 每次请求使用 Authorization: Bearer 和 Scenepond API Key 认证；密钥保存在服务器。
- 参数值区分大小写。未填写或为 null 时，存在默认值的设置使用默认值；有效的 0 和 false 会被保留。
- 参数表使用 JSON 顶层的原生字段名，也可放入 parameters 或 metadata.parameters。未知的嵌套字段和重复参数中的冲突值会被拒绝。
- 提交后返回排队任务。先轮询状态，再在 SUCCESS 后查询生成文件列表。
- POST 超时后不要自动重新提交。保存已返回的任务 ID，先检查状态，再决定是否创建新的付费任务。
- 默认值和限制依据当前网关与关联的上游参数规范；上游或网关更新后可能变化。
最小调用
1curl --fail-with-body -X POST "https://scenepond-api-production.up.railway.app/v1/tasks/fal" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY" \
3 -H "Content-Type: application/json" \
4 --data-binary @- <<'JSON'
5{
6 "model": "recraft/v4.1/flash/text-to-image",
7 "prompt": "A quiet lakeside at sunrise"
8}
9JSON在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
响应示例
响应示例仅展示结构；ID、URL 和数值为占位内容。
提交响应
1{
2 "id": "task_EXAMPLE",
3 "task_id": "task_EXAMPLE",
4 "status": "queued",
5 "model": "recraft/v4.1/flash/text-to-image",
6 "created_at": 1700000000
7}已完成任务的状态
1{
2 "task_id": "task_EXAMPLE",
3 "platform": "fal",
4 "status": "SUCCESS",
5 "progress": "100%",
6 "fail_reason": "",
7 "created_at": 1700000000,
8 "finished_at": 1700000060
9}生成文件列表
1{
2 "task_id": "task_EXAMPLE",
3 "artifacts": [
4 {
5 "key": "image-1",
6 "type": "image",
7 "content_url": "https://scenepond-api-production.up.railway.app/v1/tasks/task_EXAMPLE/artifacts/image-1/content"
8 }
9 ]
10}后续请求
2. 查询任务状态
将 SCENEPOND_TASK_ID 设为返回的 task_id，每隔几秒查询，直到 SUCCESS 或 FAILURE。状态中包含进度和 fail_reason，但不包含生成文件。
1curl --fail-with-body -X GET "https://scenepond-api-production.up.railway.app/v1/tasks/$SCENEPOND_TASK_ID" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
3. 获取生成结果
SUCCESS 后查询生成文件列表，使用返回的 content_url 和认证信息下载。请妥善保管带签名的地址。
1curl --fail-with-body -X GET "https://scenepond-api-production.up.railway.app/v1/tasks/$SCENEPOND_TASK_ID/artifacts" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
接入你的应用
在应用中通过任务 API 提交生成请求，并按任务 ID 获取结果。
模型访问权限和请求限制取决于账户、API Key 与服务配置。