跳转到主要内容
POST
https://api.ruxa.ai
/
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 '{
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "把背景变成像素风",
      "output_format": "png",
      "image_size": "1:1",
      "image_urls": ["https://example.com/your-image.png"]
    },
    "model": "google/nano-banana-edit"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
  }
}
google/nano-banana-edit 底层调用的是 Google 的 gemini-2.5-flash-image 模型，支持通过自然语言描述对现有图像进行编辑和修改。

​
查询任务状态

提交任务后，可通过统一的查询端点查看任务进度并获取生成结果：

获取任务详情

了解如何查询任务状态并获取生成结果
生产环境中，建议使用 callBackUrl 参数接收生成完成的自动通知，而非轮询状态端点。

​
授权

​
Authorization
string
必填
Bearer Token 认证。格式：Bearer sk-xxxxxx

​
请求体

请求体格式为 application/json。
​
model
string
默认值:"google/nano-banana-edit"
必填
模型名称，固定为 google/nano-banana-edit
​
callBackUrl
string
必填
任务完成后的回调地址。系统会向该 URL POST 任务状态与结果。示例：https://your-domain.com/api/callback
​
input
object
必填
生成任务的输入参数

​
响应

​
code
integer
必填
响应状态码
​
message
string
必填
响应消息，请求失败时为错误描述
​
data
object
必填
curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "把背景变成像素风",
      "output_format": "png",
      "image_size": "1:1",
      "image_urls": ["https://example.com/your-image.png"]
    },
    "model": "google/nano-banana-edit"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
  }
}