跳转到主要内容
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ruxa.ai/llms.txt

Use this file to discover all available pages before exploring further.

google/nano-banana-pro 底层调用的是 Google 的 gemini-2.5-flash-image 模型，支持更高分辨率的图像生成，并提供更精细的宽高比和分辨率控制。

​
查询任务状态

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

获取任务详情

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

​
授权

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

​
请求体

请求体格式为 application/json。
​
model
string
默认值:"google/nano-banana-pro"
必填
模型名称，固定为 google/nano-banana-pro
​
callback_url
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 '{
    "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"
  }
}