curl --request POST \
--url https://api.ruxa.ai/api/v1/tasks/create \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "https://your-domain.com/api/callback",
"input": {
"prompt": "将这张照片变成一个摇头娃娃：头部稍微放大，保持面部准确，身体卡通化。[把它放在书架上]。",
"image_input": ["https://example.com/your-image.png"],
"aspect_ratio": "1:1",
"resolution": "1k",
"output_format": "png"
},
"model": "google/nano-banana-pro"
}'
{
"code": 200,
"message": "success",
"data": {
"taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
}
}
Google
Google Nano Banana Pro
基于 Gemini 2.5 Flash Image 的高级图像生成模型 API 接口
POST
/
api
/
v1
/
tasks
/
create
curl --request POST \
--url https://api.ruxa.ai/api/v1/tasks/create \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "https://your-domain.com/api/callback",
"input": {
"prompt": "将这张照片变成一个摇头娃娃：头部稍微放大，保持面部准确，身体卡通化。[把它放在书架上]。",
"image_input": ["https://example.com/your-image.png"],
"aspect_ratio": "1:1",
"resolution": "1k",
"output_format": "png"
},
"model": "google/nano-banana-pro"
}'
{
"code": 200,
"message": "success",
"data": {
"taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
}
}
google/nano-banana-pro 底层调用的是 Google 的 gemini-2.5-flash-image
模型，支持更高分辨率的图像生成，并提供更精细的宽高比和分辨率控制。查询任务状态
提交任务后，可通过统一的查询端点查看任务进度并获取生成结果：获取任务详情
了解如何查询任务状态并获取生成结果
生产环境中，建议使用
callback_url
参数接收生成完成的自动通知，而非轮询状态端点。授权
string
必填
Bearer Token 认证。格式：
Bearer sk-xxxxxx隐藏 详细说明
隐藏 详细说明
- 获取 API Key：访问 API Key 管理页面 获取您的 API Key
-
使用方法：在请求头中添加
Authorization: Bearer YOUR_API_KEY - 注意事项：请妥善保管您的 API Key，切勿泄露给他人
- 若怀疑 API Key 泄露，请立即在管理页面重置
请求体
请求体格式为application/json。
string
默认值:"google/nano-banana-pro"
必填
模型名称，固定为
google/nano-banana-prostring
必填
任务完成后的回调地址。系统会向该 URL POST 任务状态与结果。示例：
https://your-domain.com/api/callbackobject
必填
生成任务的输入参数
隐藏 子属性
隐藏 子属性
string
必填
用于图像生成的文本提示词（最大长度：10000 字符）
隐藏 示例
隐藏 示例
"将这张照片变成一个摇头娃娃：头部稍微放大，保持面部准确，身体卡通化。[把它放在书架上]。"
string[]
必填
输入图像 URL 数组（最多支持 8 张图片）
隐藏 示例
隐藏 示例
["https://example.com/your-image.png"]
enum<string>
默认值:"1:1"
必填
生成图像的宽高比可用选项：
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, autoenum<string>
默认值:"1k"
必填
生成图像的分辨率可用选项：
1k, 2k, 4kenum<string>
默认值:"png"
必填
生成图像的输出格式可用选项：
png, jpg响应
integer
必填
响应状态码
隐藏 状态码说明
隐藏 状态码说明
-
200: 成功 - 请求已处理完成 -
401: 未授权 - 身份验证凭据缺失或无效 -
402: 积分不足 - 账户积分不足以执行该操作 -
404: 未找到 - 请求的资源或端点不存在 -
422: 验证错误 - 请求参数未通过校验 -
429: 速率限制 - 已超出该资源的请求频次限制 -
500: 服务器错误 - 处理请求时发生意外故障
string
必填
响应消息，请求失败时为错误描述
curl --request POST \
--url https://api.ruxa.ai/api/v1/tasks/create \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "https://your-domain.com/api/callback",
"input": {
"prompt": "将这张照片变成一个摇头娃娃：头部稍微放大，保持面部准确，身体卡通化。[把它放在书架上]。",
"image_input": ["https://example.com/your-image.png"],
"aspect_ratio": "1:1",
"resolution": "1k",
"output_format": "png"
},
"model": "google/nano-banana-pro"
}'
{
"code": 200,
"message": "success",
"data": {
"taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
}
}